Funzione GetCaptureComment
La funzione GetCaptureComment restituisce un puntatore al commento di un'acquisizione.
Sintassi
LPSTR WINAPI GetCaptureComment(
_In_ HCAPTURE hCapture
);
Parametri
-
hCapture [in]
-
Handle per l'acquisizione. Per altre informazioni su come ottenere l'handle di acquisizione, vedere la sezione Osservazioni.
Valore restituito
Se la funzione ha esito positivo, ovvero se l'acquisizione contiene un commento, il valore restituito è un puntatore alla stringa di commento.
Se la funzione ha esito negativo, il valore restituito è NULL.
Commenti
Non modificare la stringa di commento restituita, ovvero la stringa di commento effettiva che si trova nell'acquisizione caricata. Tutte le modifiche possono danneggiare l'acquisizione. Tenta di modificare il risultato della stringa in una violazione di accesso.
L'handle dell'acquisizione può essere ottenuto in diversi modi, a seconda che la chiamata venga effettuata da un esperto o un parser. Per gli esperti, l'handle viene specificato nel membro hCapture della struttura EXPERTSTARTUPINFO . Per i parser, l'handle di acquisizione può essere ottenuto chiamando la funzione GetFrameCaptureHandle .
Per recuperare il commento di un'acquisizione dal file di acquisizione, chiamare la funzione GetCaptureCommentFromFilename .
Esperti e parser possono chiamare la funzione GetCaptureComment .
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows 2000 Professional [solo app desktop] |
| Server minimo supportato |
Windows 2000 Server [solo app desktop] |
| Intestazione |
|
| Libreria |
|
| DLL |
|