IProviderProperties::GetValue-Methode (functiondiscoveryprovider.h)

[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 den Wert des angegebenen Eigenschaftenschlüssels ab.

Syntax

HRESULT GetValue(
  [in]  IFunctionInstance *pIFunctionInstance,
  [in]  INT_PTR           iProviderInstanceContext,
  [in]  REFPROPERTYKEY    Key,
  [out] PROPVARIANT       *ppropVar
);

Parameter

[in] pIFunctionInstance

Ein IFunctionInstance-Schnittstellenzeiger .

[in] iProviderInstanceContext

Der der spezifischen Funktion zugeordnete Kontext instance.

[in] Key

Der Eigenschaftenschlüsselverweis.

[out] ppropVar

Der Wert des durch Key angegebenen Eigenschaftenschlüssels. Der PROPVARIANT-Typ ist VT_EMPTY, wenn der Schlüssel nicht im Eigenschaftenspeicher gefunden wird.

Rückgabewert

Mögliche Rückgabewerte sind unter anderem folgendes:

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_INVALIDARG	Einer der Parameter enthält ein ungültiges Argument.
E_POINTER	Der ppropVar-Parameter ist NULL.
E_OUTOFMEMORY	Die Methode kann nicht genügend Arbeitsspeicher für die Ausführung des Vorgangs zuweisen.

Hinweise

Um den Wert eines Eigenschaftenschlüssels zu ändern, verwenden Sie die SetValue-Methode .

Wenn kein Wert für Key gefunden werden konnte, wird der Rückgabewert S_OK und ppropVar auf VT_NULL festgelegt.

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	functiondiscoveryprovider.h

Weitere Informationen

IProviderProperties