Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die ClfsGetContainerName Routine gibt den Pfadnamen eines angegebenen Containers zurück.
Syntax
CLFSUSER_API NTSTATUS ClfsGetContainerName(
[in] PLOG_FILE_OBJECT plfoLog,
[in] CLFS_CONTAINER_ID cidLogicalContainer,
[out] PUNICODE_STRING puszContainerName,
[out, optional] PULONG pcActualLenContainerName
);
Parameter
[in] plfoLog
Ein Zeiger auf eine LOG_FILE_OBJECT Struktur, die ein CLFS-Protokoll darstellt. Der Aufrufer hat diesen Zeiger zuvor durch Aufrufen ClfsCreateLogFileabgerufen.
[in] cidLogicalContainer
Der logische Bezeichner eines Containers im CLFS-Protokoll.
[out] puszContainerName
Ein Zeiger auf eine UNICODE_STRING Struktur. Der Buffer Member von puszContainerName muss auf einen vom Aufrufer zugewiesenen Puffer verweisen, der den Pfadnamen des Containers empfängt. Der MaximumLength Member muss die Größe des Puffers angeben.
[out, optional] pcActualLenContainerName
Ein Zeiger auf eine ULONG-Typvariable, die die tatsächliche Länge des Pfadnamens des Containers in Unicode-Zeichen empfängt. Dieser Parameter kann NULL-sein.
Rückgabewert
ClfsGetContainerName gibt einen der statuscodes zurück, die in Ntstatus.h definiert sind. Die folgende Tabelle gibt die Bedeutung verschiedener Rückgabewerte an.
| Rückgabecode | Beschreibung |
|---|---|
|
Das Buffer Member von puszContainerName erhält den vollständigen Pfadnamen des Containers. Wenn pcActualLenContainerName nicht NULL-ist, erhält er die tatsächliche Länge des vollständigen Pfadnamens in Unicode-Zeichen. |
|
Die tatsächliche Länge des vollständigen Pfadnamens in Unicode-Zeichen ist größer als puszContainerName->MaximumLength. Der Buffer Member von puszContainerName empfängt den vollständigen Pfadnamen des Containers, der auf die Anzahl der Zeichen abgeschnitten wird, die durch puszContainerName->MaximumLengthangegeben werden. Wenn pcActualLenContainerName nicht NULL-ist, erhält er die tatsächliche Länge des vollständigen Pfadnamens in Unicode-Zeichen. |
|
Bei rückgabe sind der Inhalt puszContainerName->Buffer und pcActualLenContainerName nicht definiert. |
Bemerkungen
Eine Erläuterung der CLFS-Konzepte und -Terminologie finden Sie unter Common Log File System.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar in Windows Server 2003 R2, Windows Vista und höheren Versionen von Windows. |
| Zielplattform- | Desktop |
| Header- | wdm.h (include Wdm.h) |
| Library | Clfs.lib |
| DLL- | Clfs.sys |
| IRQL- | <= APC_LEVEL |