Función GetLogContainerName (clfsw32.h)

Recupera el nombre de ruta de acceso completa del contenedor especificado. Esta función se usa principalmente para obtener el nombre de ruta de acceso completo de un contenedor al que se hace referencia en la estructura CLFS_CONTAINER_INFORMATION que se devuelve en llamadas a ScanLogContainers.

Sintaxis

CLFSUSER_API BOOL GetLogContainerName(
  [in]                HANDLE            hLog,
  [in]                CLFS_CONTAINER_ID cidLogicalContainer,
  [in, out]           LPCWSTR           pwstrContainerName,
  [in]                ULONG             cLenContainerName,
  [in, out, optional] PULONG            pcActualLenContainerName
);

Parámetros

[in] hLog

Identificador del registro que se obtiene de una llamada correcta a CreateLogFile.

El identificador de registro podría hacer referencia a una secuencia de registro o a un registro físico.

[in] cidLogicalContainer

Identificador único asociado a un contenedor.

[in, out] pwstrContainerName

Puntero a un búfer asignado por el usuario para recibir la ruta de acceso completa y el nombre del contenedor de registro, en caracteres anchos.

[in] cLenContainerName

Tamaño del búfer al que apunta pwstrContainerName, en caracteres.

[in, out, optional] pcActualLenContainerName

Puntero a una variable para recibir el recuento de caracteres real del nombre de ruta de acceso del contenedor completo que se recupera.

Si la función se ejecuta correctamente, el valor de este parámetro es menor o igual que cLenContainerName. Si el búfer no es lo suficientemente grande como para almacenar el nombre completo de la ruta de acceso del contenedor, se produce un error en la función con ERROR_MORE_DATA y establece este parámetro en el tamaño necesario para el nombre de la ruta de acceso completa. Para otros errores, el valor no está definido.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es distinto de cero.

Si la función no se realiza correctamente, el valor devuelto es cero (0). Para obtener información de error extendida, llame a GetLastError. En la lista siguiente se identifican los posibles códigos de error:

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	clfsw32.h
Library	Clfsw32.lib
Archivo DLL	Clfsw32.dll

Consulte también

CLFS_CONTAINER_INFORMATION

Funciones comunes del sistema de archivos de registro

ScanLogContainers