IWbemPath::GetNamespaceAt-Methode (wmiutils.h)
Die IWbemPath::GetNamespaceAt-Methode ruft einen Namespace basierend auf seinem Index ab. Der am weitesten links stehende Namespace im Pfad weist den Index 0 auf, wobei jeder Nach rechts verschobene Namespace einen progressiv höheren Indexwert aufweist.
Syntax
HRESULT GetNamespaceAt(
[in] ULONG uIndex,
[in, out] ULONG *puNameBufLength,
[in, out] LPWSTR pName
);
Parameter
[in] uIndex
Index des zu lesenden Namespaces. Der am weitesten links stehende Namespace im Pfad ist Index 0, wobei jeder Namespace rechts über einen progressiv höheren Indexwert verfügt. Der maximal zulässige Wert ist ein Wert kleiner als die aktuelle Anzahl von Namespaces.
[in, out] puNameBufLength
Der Aufrufer legt dies auf die Anzahl der Zeichen fest, die der Puffer 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] pName
Namespacename.
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 für pName ist. Dazu wird ein NULL-Zeiger für den Puffer übergeben, puNameBufLength auf 0 festgelegt und dann der Aufruf ausgeführt. Bei der Rückgabe gibt puNameBufLength an, wie groß ein Puffer für pName und dessen endendes 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 |