Condividi tramite

Funzione ClfsGetContainerName (wdm.h)

  • Articolo

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