Fungsi ClfsGetContainerName (wdm.h)

Artikel
08/08/2023

Rutinitas ClfsGetContainerName mengembalikan nama jalur kontainer tertentu.

Sintaks

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

Penunjuk ke struktur LOG_FILE_OBJECT yang mewakili log CLFS. Pemanggil sebelumnya mendapatkan pointer ini dengan memanggil ClfsCreateLogFile.

[in] cidLogicalContainer

Pengidentifikasi logis kontainer di log CLFS.

[out] puszContainerName

Penunjuk ke struktur UNICODE_STRING . Anggota BufferpuszContainerName harus menunjuk ke buffer yang dialokasikan pemanggil yang menerima nama jalur kontainer. Anggota MaximumLength harus menyediakan ukuran buffer.

[out, optional] pcActualLenContainerName

Penunjuk ke variabel berjenis ULONG yang menerima panjang aktual, dalam karakter Unicode, dari nama jalur kontainer. Parameter ini bisa NULL.

Nilai kembali

ClfsGetContainerName mengembalikan salah satu kode status yang ditentukan dalam Ntstatus.h. Tabel berikut ini memberikan arti dari berbagai nilai pengembalian.

Menampilkan kode	Deskripsi
STATUS_SUCCESS	Anggota BufferpuszContainerName menerima nama jalur lengkap kontainer. Jika pcActualLenContainerName bukan NULL, pcActualLenContainerName menerima panjang aktual, dalam karakter Unicode, dari nama jalur lengkap.
STATUS_BUFFER_OVERFLOW	Panjang aktual, dalam karakter Unicode, dari nama jalur lengkap lebih besar dari puszContainerName->MaximumLength. Anggota BufferpuszContainerName menerima nama jalur lengkap kontainer yang dipotong menjadi jumlah karakter yang ditentukan oleh puszContainerName->MaximumLength. Jika pcActualLenContainerName bukan NULL, pcActualLenContainerName menerima panjang aktual, dalam karakter Unicode, dari nama jalur lengkap.
Lainnya	Saat dikembalikan, konten puszContainerName->Buffer dan pcActualLenContainerName tidak terdefinisi.

Keterangan

Untuk penjelasan tentang konsep dan terminologi CLFS, lihat Sistem File Log Umum.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows Server 2003 R2, Windows Vista, dan versi Windows yang lebih baru.
Target Platform	Desktop
Header	wdm.h (termasuk Wdm.h)
Pustaka	Clfs.lib
DLL	Clfs.sys
IRQL	<= APC_LEVEL

Lihat juga

ClfsAddLogContainer

ClfsRemoveLogContainer