Funzione PdhConnectMachineA (pdh.h)
Si connette al computer specificato.
Sintassi
PDH_FUNCTION PdhConnectMachineA(
[in] LPCSTR szMachineName
);
Parametri
[in] szMachineName
nullstringa con terminazione che specifica il nome del computer a cui connettersi. Se NULL, PDH si connette al computer locale.
Valore restituito
Se la funzione ha esito positivo, restituisce ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema o un codice di errore PDH . Di seguito sono riportati i valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Impossibile connettersi al computer specificato. È possibile che il computer non sia attivo, che non supporti PDH, non sia connesso alla rete o abbia le autorizzazioni impostate nel Registro di sistema che impediscono connessioni remote o monitoraggio delle prestazioni remote da parte dell'utente. |
|
Impossibile allocare un blocco di memoria dinamico. Si verifica quando si verifica una grave carenza di memoria nel sistema a causa di troppe applicazioni in esecuzione nel sistema o di un file di paging della memoria insufficiente. |
Osservazioni
In genere, le applicazioni non chiamano questa funzione e la connessione viene eseguita quando l'applicazione aggiunge il contatore alla query.
Tuttavia, è possibile utilizzare questa funzione se si desidera includere più del computer locale nella Selezionare contatori dal computer elenco nella finestra di dialogo sfoglia contatori. Per informazioni dettagliate, vedere la struttura PDH_BROWSE_DLG_CONFIG.
Nota
L'intestazione pdh.h definisce PdhConnectMachine come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows XP [solo app desktop] |
| server minimo supportato | Windows Server 2003 [solo app desktop] |
| piattaforma di destinazione | Finestre |
| intestazione |
pdh.h |
| libreria |
Pdh.lib |
| dll | Pdh.dll |