IWbemPathKeyList::GetKey-Methode (wmiutils.h)
Die IWbemPathKeyList::GetKey-Methode ruft den Namen oder Wert eines Schlüssels ab. Schlüssel werden ab 0 (null) indiziert, obwohl die Reihenfolge der Schlüssel nicht signifikant ist.
Syntax
HRESULT GetKey(
[in] ULONG uKeyIx,
[in] ULONG uFlags,
[in, out] ULONG *puNameBufSize,
[in, out] LPWSTR pszKeyName,
[in, out] ULONG *puKeyValBufSize,
[in, out] LPVOID pKeyVal,
[in, out] ULONG *puApparentCimType
);
Parameter
[in] uKeyIx
Schlüsselindex beginnt bei 0 (null).
[in] uFlags
Reserviert. Muss 0 (null) sein.
[in, out] puNameBufSize
Der Aufrufer legt dies 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 wurden, einschließlich des beendenden NULL.
[in, out] pszKeyName
Puffer, in den der Name kopiert werden soll. Da nicht alle Schlüssel einen Namen haben, wäre dieser Parameterwert für einen impliziten Schlüssel NULL .
[in, out] puKeyValBufSize
Der Aufrufer legt dies auf die Anzahl der Zeichen fest, die der Wertpuffer enthalten kann. Bei erfolgreicher Ausführung wird dies auf die Anzahl der Zeichen festgelegt, die in den Puffer kopiert wurden, einschließlich des NULL-Abschlusszeichens .
[in, out] pKeyVal
Puffer, in den Daten kopiert werden sollen.
[in, out] puApparentCimType
Zeiger auf einen long-Wert, der auf den CIM-Typ festgelegt ist.
Rückgabewert
Diese Methode gibt ein HRESULT zurück, das den Status des Methodenaufrufs angibt.
Hinweise
Es wird empfohlen, die erforderliche Größe eines Puffers zu bestimmen, indem Sie diese Methode aufrufen, einen NULL-Zeiger für den Puffer übergeben und dessen Größenparameter auf 0 (null) festlegen. Bei der Rückgabe gibt der Size-Parameter des Puffers an, wie groß ein Puffer für die Zeichenfolge und deren NULL-Abschlusszeichen ist. Anschließend können Sie die -Methode aufrufen, um den Pufferwert abzurufen.
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 |