ITLegacyCallMediaControl::GetID-Methode (tapi3if.h)
Die GetID-Methode ruft den Bezeichner für das Gerät ab, das dem aktuellen Aufruf zugeordnet ist.
Diese Methode ist für C/C++-Anwendungen vorgesehen. Visual Basic- und Skriptanwendungen sollten die METHODE ITLegacyCallMediaControl2::GetIDAsVariant verwenden.
Syntax
HRESULT GetID(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceID
);
Parameter
[in] pDeviceClass
Zeiger auf BSTR , der die TAPI-Geräteklasse darstellt.
[out] pdwSize
Größe des Gerätebezeichners in Byte.
[out] ppDeviceID
Gerätebezeichner.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen. |
|
Der PdwSize - oder ppDeviceID-Parameter ist kein gültiger Zeiger. |
Hinweise
Die Anwendung muss ITTAPI::RegisterCallNotifications aufrufen, bevor diese Methode aufgerufen wird.
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDeviceClass-Parameter zuzuweisen, und SysFreeString muss den Arbeitsspeicher freigeben, wenn die Variable nicht mehr benötigt wird.
Die Anwendung muss die CoTaskMemFree-Funktion aufrufen, um den für den ppDeviceID-Parameter zugeordneten Arbeitsspeicher freizugeben.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (Tapi3.h einschließen) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |