PdhConnectMachineA-Funktion (pdh.h)

  • Artikel

Stellt eine Verbindung mit dem angegebenen Computer her.

Syntax

PDH_FUNCTION PdhConnectMachineA(
  [in] LPCSTR szMachineName
);

Parameter

[in] szMachineName

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

Rückgabewert

Wenn die Funktion erfolgreich ist, wird ERROR_SUCCESS zurückgegeben.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode oder ein PDH-Fehlercode. Die folgenden Werte sind möglich.

Rückgabecode Beschreibung
PDH_CSTATUS_NO_MACHINE
 Es kann keine Verbindung mit dem angegebenen Computer hergestellt werden. Dies kann darauf zurückzuführen sein, 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 es aufgrund zu vieler Anwendungen, die auf dem System ausgeführt werden, oder einer unzureichenden Speicher-Auslagerungsdatei zu einem schwerwiegenden Speichermangel im System kommt.

Hinweise

In der Regel rufen Anwendungen diese Funktion nicht auf, und stattdessen wird die Verbindung hergestellt, wenn die Anwendung den Zähler zur 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. Weitere 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 Code, der nicht Codierungsneutral ist, 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