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 |