Funzione ClfsGetContainerName (wdm.h)

Articolo
02/29/2024

La routine ClfsGetContainerName restituisce il nome del percorso di un contenitore specificato.

Sintassi

CLFSUSER_API NTSTATUS ClfsGetContainerName(
  [in]            PLOG_FILE_OBJECT  plfoLog,
  [in]            CLFS_CONTAINER_ID cidLogicalContainer,
  [out]           PUNICODE_STRING   puszContainerName,
  [out, optional] PULONG            pcActualLenContainerName
);

Parametri

[in] plfoLog

Puntatore a una struttura LOG_FILE_OBJECT che rappresenta un log CLFS. Il chiamante ha ottenuto in precedenza questo puntatore chiamando ClfsCreateLogFile.

[in] cidLogicalContainer

Identificatore logico di un contenitore nel log CLFS.

[out] puszContainerName

Puntatore a una struttura UNICODE_STRING . Il membro Buffer di puszContainerName deve puntare a un buffer allocato dal chiamante che riceve il nome del percorso del contenitore. Il membro MaximumLength deve fornire le dimensioni del buffer.

[out, optional] pcActualLenContainerName

Puntatore a una variabile tipizzata ULONG che riceve la lunghezza effettiva, in caratteri Unicode, del nome del percorso del contenitore. Questo parametro può essere NULL.

Valore restituito

ClfsGetContainerName restituisce uno dei codici di stato definiti in Ntstatus.h. La tabella seguente fornisce i significati dei vari valori restituiti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il membro Buffer di puszContainerName riceve il nome del percorso completo del contenitore. Se pcActualLenContainerName non è NULL, riceve la lunghezza effettiva, in caratteri Unicode, del nome completo del percorso.
STATUS_BUFFER_OVERFLOW	La lunghezza effettiva, in caratteri Unicode, del nome del percorso completo è maggiore di puszContainerName->MaximumLength. Il membro Buffer di puszContainerName riceve il nome del percorso completo del contenitore troncato al numero di caratteri specificato da puszContainerName->MaximumLength. Se pcActualLenContainerName non è NULL, riceve la lunghezza effettiva, in caratteri Unicode, del nome completo del percorso.
Altri	In caso di restituzione, il contenuto di puszContainerName->Buffer e pcActualLenContainerName non sono definiti.

Commenti

Per una spiegazione dei concetti e della terminologia di CLFS, vedere Common Log File System.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows Server 2003 R2, Windows Vista e versioni successive di Windows.
Piattaforma di destinazione	Desktop
Intestazione	wdm.h (include Wdm.h)
Libreria	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Vedi anche

ClfsAddLogContainer

ClfsRemoveLogContainer

Condividi tramite