PdhConnectMachineW-Funktion (pdh.h)

  • Artikel

Stellt eine Verbindung mit dem angegebenen Computer her.

Syntax

PDH_FUNCTION PdhConnectMachineW(
  [in] LPCWSTR szMachineName
);

Parameter

[in] szMachineName

Null-beendete Zeichenfolge, die den Namen des Computers angibt, mit dem eine Verbindung hergestellt werden soll. Bei NULL stellt PDH eine Verbindung mit dem lokalen Computer her.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie ERROR_SUCCESS zurück.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Im Folgenden sind mögliche Werte aufgeführt.

Rückgabecode Beschreibung
PDH_CSTATUS_NO_MACHINE
 Es kann keine Verbindung mit dem angegebenen Computer hergestellt werden. Kann dadurch verursacht werden, dass der Computer nicht eingeschaltet ist, PDH nicht unterstützt, nicht mit dem Netzwerk verbunden ist oder dass die Berechtigungen für die Registrierung festgelegt sind, die Remoteverbindungen oder die Remoteleistungsüberwachung durch den Benutzer verhindern.
PDH_MEMORY_ALLOCATION_FAILURE
 Ein dynamischer Speicherblock kann nicht zugeordnet werden. Tritt auf, wenn im System aufgrund zu vieler Anwendungen, die auf dem System ausgeführt werden, oder aufgrund einer unzureichenden Speicher paging-Datei ein schwerwiegender Speichermangel auftritt.

Hinweise

In der Regel rufen Anwendungen diese Funktion nicht auf, und stattdessen wird die Verbindung hergestellt, wenn die Anwendung den Zähler der Abfrage hinzufügt.

Sie können diese Funktion jedoch verwenden, wenn Sie mehr als den lokalen Computer in die Liste Indikatoren vom Computer auswählen im Dialogfeld Indikatoren durchsuchen einschließen möchten. Ausführliche Informationen finden Sie in der PDH_BROWSE_DLG_CONFIG-Struktur .

Hinweis

Der pdh.h-Header definiert PdhConnectMachine als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile pdh.h
Bibliothek Pdh.lib
DLL Pdh.dll

Weitere Informationen

PdhEnumMachines