ITAddressCapabilities::get_AddressCapabilityString-Methode (tapi3if.h)

  • Artikel

Die get_AddressCapabilityString-Methode ruft die Funktionszeichenfolge für eine bestimmte ADDRESS_CAPABILITY_STRING ab.

Syntax

HRESULT get_AddressCapabilityString(
  [in]  ADDRESS_CAPABILITY_STRING AddressCapString,
  [out] BSTR                      *ppCapabilityString
);

Parameter

[in] AddressCapString

Deskriptor für die gewünschte Adressfunktionszeichenfolge.

[out] ppCapabilityString

Zeiger auf den BSTR-Wert der Adressfunktion. NULL ist ein möglicher Rückgabewert, wenn der TSP keinen Wert für AddressCapString bereitstellt.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
 Methode war erfolgreich.
E_INVALIDARG
 Der AddressCapString-Parameter ist ungültig.
E_POINTER
 Der ppCapabilityString-Parameter ist kein gültiger Zeiger.
TAPI_E_NOTSUPPORTED
 Die TAPI-Version ist nicht 3.0 oder höher.
E_OUTOFMEMORY
 Es ist nicht genügend Arbeitsspeicher vorhanden, um den Vorgang auszuführen.

Hinweise

Die Anwendung muss SysFreeString verwenden, um den für den ppCapabilityString-Parameter zugeordneten Arbeitsspeicher freizugeben.

Anforderungen

Anforderung Wert
Zielplattform Windows
Kopfzeile tapi3if.h (Tapi3.h einschließen)
Bibliothek Uuid.lib
DLL Tapi3.dll

Weitere Informationen

ADDRESS_CAPABILITY_STRING

Address-Objekt

ITAddressCapabilities