PdhConnectMachineW-Funktion (pdh.h)
Stellt eine Verbindung mit dem angegebenen Computer hergestellt.
Syntax
PDH_FUNCTION PdhConnectMachineW(
[in] LPCWSTR szMachineName
);
Parameter
[in] szMachineName
Null-Zeichenfolge-terminated, die den Namen des Computers angibt, mit dem eine Verbindung hergestellt werden soll. Wenn NULL-, stellt PDH eine Verbindung mit dem lokalen Computer bereit.
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. Im Folgenden sind mögliche Werte aufgeführt.
| Rückgabecode | Beschreibung |
|---|---|
|
Es kann keine Verbindung mit dem angegebenen Computer hergestellt werden. Kann dadurch verursacht werden, dass der Computer nicht aktiviert ist, pdH nicht unterstützt, nicht mit dem Netzwerk verbunden ist oder die Berechtigungen für die Registrierung festgelegt sind, die Remoteverbindungen oder Remoteleistungsüberwachung durch den Benutzer verhindern. |
|
Ein dynamischer Speicherblock kann nicht zugewiesen werden. Tritt auf, wenn ein schwerwiegender Speichermangel im System aufgrund zu vieler Anwendungen auftritt, die auf dem System ausgeführt werden, oder aufgrund einer unzureichenden Speicher paging-Datei. |
Bemerkungen
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 Zähler vom Computer auswählen möchten, Liste im Dialogfeld Suchzähler. Ausführliche Informationen finden Sie in der PDH_BROWSE_DLG_CONFIG Struktur.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows XP [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows Server 2003 [Nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | pdh.h |
| Library | Pdh.lib |
| DLL- | Pdh.dll |