Funzione PdhSelectDataSourceW (pdh.h)

Articolo
11/20/2024

Visualizza una finestra di dialogo che richiede all'utente di specificare l'origine dei dati sulle prestazioni.

Sintassi

PDH_FUNCTION PdhSelectDataSourceW(
  [in]      HWND    hWndOwner,
  [in]      DWORD   dwFlags,
  [out]     LPWSTR  szDataSource,
  [in, out] LPDWORD pcchBufferLength
);

Parametri

[in] hWndOwner

Proprietario della finestra di dialogo. Può essere NULL se non è presente alcun proprietario (il desktop diventa il proprietario).

[in] dwFlags

Finestre di dialogo che verranno visualizzate per richiedere l'origine dati. Questo parametro può essere uno dei valori seguenti.

Valore	Significato
PDH_FLAGS_FILE_BROWSER_ONLY	Visualizzare solo il browser file. Impostare questo flag quando si desidera richiedere solo il nome e il percorso di un file di log.
0	Consente di visualizzare la finestra di dialogo di selezione dell'origine dati. La finestra di dialogo consente all'utente di selezionare i dati sulle prestazioni da un file di log o da un'origine in tempo reale. Se l'utente ha specificato che i dati devono essere raccolti da un file di log, viene visualizzato un browser di file per specificare il nome e il percorso del file di log.

[out] szDataSource

Buffer allocato dal chiamante che riceve un nullstringa con terminazione contenente il nome di un file di log selezionato dall'utente. Il nome del file di log viene troncato alle dimensioni del buffer se il buffer è troppo piccolo.

Se l'utente ha selezionato un'origine in tempo reale, il buffer è vuoto.

[in, out] pcchBufferLength

Dimensione massima del buffer szDataSource , in TCHAR.

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
PDH_INVALID_ARGUMENT	La lunghezza del buffer passato nel pcchBufferLength non è uguale alla lunghezza effettiva del buffer szDataSource.
PDH_MEMORY_ALLOCATION_FAILURE	È stato passato un buffer di lunghezza zero nel parametro szDataSource.

Osservazioni

Nota

L'intestazione pdh.h definisce PdhSelectDataSource 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

Vedere anche

PdhIsRealTimeQuery

Condividi tramite