Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Funktionsermittlung ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]
Ruft die Bezeichnerzeichenfolge für die funktion instance ab. Dieser Bezeichner kann gespeichert und später verwendet werden, um dieselbe Funktion instance über IFunctionDiscovery::GetInstance erneut abzufragen.
Syntax
HRESULT GetID(
[out] WCHAR **ppszCoMemIdentity
);
Parameter
[out] ppszCoMemIdentity
Die Funktion instance Bezeichnerzeichenfolge. Es gibt keine Obergrenze für die Größe dieser Zeichenfolge.
Diese Zeichenfolge ist eine zusammengesetzte Zeichenfolge, die von der Funktionsermittlung generiert wird. Es verfügt über den Anbieter instance Bezeichnerzeichenfolge als Teilzeichenfolge. Weitere Informationen zu Anbieterbezeichnern finden Sie unter IFunctionInstance::GetProviderInstanceID.
Bei Funktionsinstanzen, die von einem integrierten Anbieter zurückgegeben werden, wird mit diesem Bezeichner garantiert, dass eine Ressource auf einem System eindeutig identifiziert wird, auch wenn die Ressource getrennt und wieder verbunden ist. Bei Funktionsinstanzen, die von benutzerdefinierten Anbietern zurückgegeben werden, ist die Funktion instance Bezeichner eindeutig, wenn der Anbieter über einen eindeutigen Anbieterbezeichner verfügt.
Dieser Bezeichner sollte nicht programmgesteuert bearbeitet oder hergestellt werden. Die Zeichenfolge sollte nur zum Abrufen von Funktionsinstanzen und zu Vergleichszwecken verwendet werden.
Stellen Sie sicher, dass Sie diesen Puffer mit CoTaskMemFree freigeben.
Rückgabewert
Mögliche Rückgabewerte sind unter anderem folgendes:
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
Der Wert von ppszCoMemID ist ungültig. |
|
Die -Methode kann den für diesen Vorgang erforderlichen Arbeitsspeicher nicht zuordnen. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | functiondiscoveryapi.h |
| DLL | FunDisc.dll |