Funzione ClfsGetContainerName (wdm.h)

Articolo
02/07/2025

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 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 buffer membro 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 di vari valori restituiti.

Codice restituito	Descrizione
STATUS_SUCCESS	Il membro buffer di puszContainerName riceve il nome completo del percorso 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 completo del percorso è maggiore di puszContainerName->MaximumLength. Il membro buffer di puszContainerName riceve il nome completo del percorso 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.
Altro	In caso di restituzione, il contenuto di puszContainerName->Buffer e pcActualLenContainerName non sono definiti.

Osservazioni

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

Fabbisogno

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

Vedere anche

ClfsAddLogContainer

ClfsRemoveLogContainer

Condividi tramite