IWbemPath::GetScopeAsText-Methode (wmiutils.h)
Die IWbemPath::GetScopeAsText-Methode ruft einen Bereich im Textformat basierend auf einem Index ab.
Syntax
HRESULT GetScopeAsText(
[in] ULONG uIndex,
[in, out] ULONG *puTextBufSize,
[out] LPWSTR pszText
);
Parameter
[in] uIndex
Index des Bereichs.
[in, out] puTextBufSize
Der Aufrufer legt dies auf die Anzahl der Zeichen fest, die der Puffer enthalten kann. Nach erfolgreicher Ausführung wird dies auf die Anzahl der Zeichen festgelegt, die in den Puffer kopiert wurden, einschließlich des NULL-Abschlusszeichens .
[out] pszText
Puffer, in den der Bereich kopiert werden soll.
Rückgabewert
Diese Methode gibt die folgenden Werte zurück.
Hinweise
Diese Methode kann verwendet werden, um zu bestimmen, wie groß ein Puffer für pszText ist. Hierzu wird ein NULL-Zeiger für den Puffer übergeben, puTextBufSize auf 0 (0) festgelegt und anschließend aufgerufen. Bei der Rückgabe gibt puTextBufSize an, wie groß ein Puffer für pszText und dessen abschließendes NULL-Zeichen ist.
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 |