ITAddressCapabilities::get_AddressCapabilityString-Methode (tapi3if.h)

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