?? func2_1e7i.htm
字號:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML DIR="LTR"><HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; CHARSET=iso8859-1">
</HEAD>
<TITLE>phoneGetIcon</TITLE>
<SCRIPT SRC="/library/psdk/linkcss.js"></SCRIPT>
<META NAME="MS-HKWD" CONTENT="phoneGetIcon">
<META NAME="MS-HAID" CONTENT="_tapi2_phonegeticon">
</HEAD>
<BODY TOPMARGIN="0">
<!--TOOLBAR_START-->
<!--TOOLBAR_EXEMPT-->
<!--TOOLBAR_END-->
<!--SYNC_START-->
<script language="JavaScript" src='/library/synch.js'></script>
<!--SYNC_END-->
<H1><A NAME="_tapi2_phonegeticon"></A>phoneGetIcon</H1>
<P>The <B>phoneGetIcon</B> function allows an application to retrieve a service phone device-specific (or provider-specific) icon that can be displayed to the user. </P>
<PRE class=syntax><B>LONG WINAPI phoneGetIcon(
DWORD</B><I> dwDeviceID</I><B>, </B>
<B> LPCSTR</B><I> lpszDeviceClass</I><B>, </B>
<B> LPHICON</B><I> lphIcon </I>
<B>);</B></PRE>
<H4>Parameters</H4>
<DL>
<DT><I>dwDeviceID</I> </DT>
<DD>The phone device whose icon is requested. </DD>
<DT><I>lpszDeviceClass</I> </DT>
<DD>A pointer to a null-terminated string that identifies a device class name. This device class allows the application to select a specific sub-icon applicable to that device class. This parameter is optional and can be left NULL or empty, in which case the highest-level icon associated with the phone device rather than a specified media stream device would be selected. </DD>
<DT><I>lphIcon</I> </DT>
<DD>A pointer to a memory location in which the handle to the icon is returned.
</DD>
</DL>
<H4>Return Values</H4>
<P>Returns zero if the request succeeds or a negative error number if an error occurs. Possible return values are: </P>
<P>PHONEERR_BADDEVICEID, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_OPERATIONFAILED, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_NOMEM, PHONEERR_NODEVICE.</P>
<H4>Remarks</H4>
<P>The <B>phoneGetIcon</B> function causes the provider to return a handle (in <I>lphIcon</I>) to an icon resource (obtained from <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/winui/icons_799r.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/winui/icons_799r.htm'" tppabs="http://msdn.microsoft.com/library/psdk/winui/icons_799r.htm"><B>LoadIcon</B></A>) associated with the specified phone. The icon handle is for a resource associated with the provider; the application must use <A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/winui/icons_799q.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/winui/icons_799q.htm'" tppabs="http://msdn.microsoft.com/library/psdk/winui/icons_799q.htm"><B>CopyIcon</B></A> if it wants to reference the icon after the provider is unloaded, which is unlikely to happen as long as the application has the phone open. </P>
<P>The<I> lpszDeviceClass</I> parameter allows the provider to return different icons based on the type of service being referenced by the caller. The permitted strings are the same as for <A HREF="func2_1qxw.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_1qxw.htm"><B>phoneGetID</B></A>. For example, if the phone supports the Comm API, passing "COMM" as <I>lpszDeviceClass</I> causes the provider to return an icon related specifically to the Comm device functions of the service provider. The parameters "tapi/phone", "", or NULL can be used to request the icon for the phone service. </P>
<P>For applications using a TAPI version earlier than 2.0, if the provider does not return an icon (whether because the given device class is invalid or the provider does not support icons), TAPI substitutes a generic Win32 Telephony phone device icon. For applications using TAPI version 2.0 or later, TAPI substitutes the default phone icon <I>only</I> if the <I>lpszDeviceClass</I> parameter is "tapi/phone", "", or NULL. For any other device class, if the given device class is not valid or the provider does not support icons for the class, <B>phoneGetIcon</B> returns PHONEERR_INVALDEVICECLASS. </P>
<H4><A HREF="javascript:if(confirm('http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm'" tppabs="http://msdn.microsoft.com/library/psdk/sdkintro/guide_927n.htm">Requirements</A> </H4>
<P><B> Windows NT/2000: </B>Requires Windows NT 4.0 SP3 or later.<BR>
<B> Windows 95/98: </B>Requires Windows 95 or later.<BR>
<B> Version: </B>Requires TAPI 1.3 or later.<BR>
<B> Header: </B>Declared in Tapi.h.<BR>
<B> Library: </B>Use Tapi32.lib.<BR>
<B> Unicode: </B>Implemented as Unicode and ANSI versions on all platforms.</P>
<H4>See Also</H4>
<P><A HREF="quickref_1okl.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_1okl.htm">TAPI 2.2 Reference Overview</A>, <A HREF="quickref_4rub.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/quickref_4rub.htm">Supplementary Phone Service Functions</A>, <A HREF="func2_1qxw.htm" tppabs="http://msdn.microsoft.com/library/psdk/tapi22/func2_1qxw.htm"><B>phoneGetID</B></A></P>
<DIV CLASS="footer">Built on Monday, August 14, 2000</DIV>
<!--FOOTER_START-->
<DIV CLASS="footer" STYLE="color:#000000;font-size:90%;">
<A HREF="mailto:sdkfdbk@microsoft.com">Send feedback</A> to the Platform SDK.</P>
<P><A HREF="javascript:if(confirm('http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm \n\n這個文件不能通過 Teleport Pro 取回, 因為 地址在一個域或為它的開始地址設定的邊界的外部路徑上. \n\n你想從服務器打開它嗎?'))window.location='http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm'" tppabs="http://msdn.microsoft.com/isapi/gomscom.asp?TARGET=/info/cpyright.htm" TARGET="_top">© 1999 Microsoft Corporation. All rights reserved. Terms of use.</A></P>
</DIV>
<!--FOOTER_END-->
</BODY>
</HTML>
?? 快捷鍵說明
復制代碼
Ctrl + C
搜索代碼
Ctrl + F
全屏模式
F11
切換主題
Ctrl + Shift + D
顯示快捷鍵
?
增大字號
Ctrl + =
減小字號
Ctrl + -