Funzione GetLogContainerName (clfsw32.h)

Articolo
03/05/2024

Recupera il nome completo del percorso del contenitore specificato. Questa funzione viene usata principalmente per ottenere il nome del percorso completo di un contenitore a cui si fa riferimento nella struttura CLFS_CONTAINER_INFORMATION restituita nelle chiamate a ScanLogContainers.

Sintassi

CLFSUSER_API BOOL GetLogContainerName(
  [in]                HANDLE            hLog,
  [in]                CLFS_CONTAINER_ID cidLogicalContainer,
  [in, out]           LPCWSTR           pwstrContainerName,
  [in]                ULONG             cLenContainerName,
  [in, out, optional] PULONG            pcActualLenContainerName
);

Parametri

[in] hLog

Handle per il log ottenuto da una chiamata riuscita a CreateLogFile.

L'handle di log può fare riferimento a un flusso di log o a un log fisico.

[in] cidLogicalContainer

Identificatore univoco associato a un contenitore.

[in, out] pwstrContainerName

Puntatore a un buffer allocato dall'utente per ricevere il percorso completo e il nome del contenitore di log, in caratteri wide.

[in] cLenContainerName

Dimensioni del buffer a cui punta pwstrContainerName, in caratteri.

[in, out, optional] pcActualLenContainerName

Puntatore a una variabile per ricevere il conteggio dei caratteri effettivo del nome completo del percorso del contenitore recuperato.

Se la funzione ha esito positivo, il valore di questo parametro è minore o uguale a cLenContainerName. Se il buffer non è sufficientemente grande da archiviare l'intero nome del percorso del contenitore, la funzione ha esito negativo con ERROR_MORE_DATA e imposta questo parametro sulle dimensioni necessarie per il nome del percorso completo. Per altri errori, il valore non è definito.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero (0). Per informazioni dettagliate sull'errore, chiamare GetLastError. L'elenco seguente identifica i possibili codici di errore:

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	clfsw32.h
Libreria	Clfsw32.lib
DLL	Clfsw32.dll

Vedi anche

CLFS_CONTAINER_INFORMATION

Funzioni comuni del file system di log

ScanLogContainers

Condividi tramite