IWbemPathKeyList::GetKey2-Methode (wmiutils.h)
Die IWbemPathKeyList::GetKey2-Methode ruft einen Schlüsselnamen oder -wert ab und gibt den Wert als VARIANT zurück. Ein Schlüssel wird von 0 (null) indiziert, aber die Schlüsselreihenfolge ist nicht signifikant.
Syntax
HRESULT GetKey2(
[in] ULONG uKeyIx,
[in] ULONG uFlags,
[in, out] ULONG *puNameBufSize,
[out] LPWSTR pszKeyName,
[out] VARIANT *pKeyValue,
[out] ULONG *puApparentCimType
);
Parameter
[in] uKeyIx
Der Schlüsselindex beginnt bei 0 (null).
[in] uFlags
Reserviert. Muss 0 (null) sein.
[in, out] puNameBufSize
Der Aufrufer legt diesen Parameter auf die Anzahl der Zeichen fest, die der Namenspuffer enthalten kann. Bei erfolgreicher Ausführung wird dies auf die Anzahl der Zeichen festgelegt, die in den Puffer kopiert werden , einschließlich der beendenden NULL.
[out] pszKeyName
Puffer, in den der Name kopiert wird. Da nicht alle Schlüssel einen Namen haben , ist dieser Parameterwert null für einen impliziten Schlüssel.
[out] pKeyValue
Zeiger auf eine Variante, die den Schlüsselwert enthält.
[out] puApparentCimType
Zeiger auf eine lange ganze Zahl, die auf den CIM-Typ festgelegt ist.
Rückgabewert
Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt.
Hinweise
Diese Methode kann verwendet werden, um zu bestimmen, wie groß ein Puffer benötigt wird, indem ein NULL-Zeiger für den Puffer übergeben und dessen Größenparameter auf 0 (null) festgelegt wird. Wenn er zurückgegeben wird, gibt der Parameter puffergröße den Größenpuffer an, der für die Zeichenfolge und ihren NULL-Abschlussator benötigt wird.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows Vista |
| Unterstützte Mindestversion (Server) | Windows Server 2008 |
| Zielplattform | Windows |
| Kopfzeile | wmiutils.h |
| Bibliothek | Wbemuuid.lib |
| DLL | Wmiutils.dll |