Función CertSrvRestoreGetDatabaseLocationsW (certbcli.h)
La función CertSrvRestoreGetDatabaseLocations se usa en escenarios de copia de seguridad y restauración y recupera la lista de nombres de ubicación de la base de datos de Servicios de certificados para todos los archivos de los que se realiza una copia de seguridad o restauración.
Sintaxis
HRESULT CERTBCLI_API CertSrvRestoreGetDatabaseLocationsW(
[in] HCSBC hbc,
[out] PWSTR *ppwszzDatabaseLocationList,
[out] DWORD *pcbSize
);
Parámetros
[in] hbc
Identificador de un contexto de copia de seguridad o restauración de Servicios de certificados.
[out] ppwszzDatabaseLocationList
Puntero a un puntero WCHAR para recibir la lista de nombres de ubicación de base de datos terminadas en NULL, nombre del directorio de registro y nombre del directorio del sistema (o punto de control). Hay un carácter nulo después de cada nombre y un carácter nulo adicional al final de la lista. El nombre de la ubicación estará en el formulario UNC "## \\Server\SharePoint\... Path...\FileName.ext". Los nombres de directorio tendrán el mismo formato, pero sin el final "\FileName.ext". El texto "##" denota un tipo de archivo de copia de seguridad de Servicios de certificados (CSBFT_*) y se almacena como un único carácter Unicode no nulo precedido en cada ruta de acceso UNC. La etiqueta de tipo se define en Certbcli.h y puede ser uno de los siguientes valores para esta función.
Debe liberar esta memoria asignada cuando haya terminado llamando a CertSrvBackupFree.
Establecer *ppwszzDatabaseLocationList en NULL antes de llamar a esta función es opcional.
[out] pcbSize
Puntero al valor DWORD que especifica el número de bytes en ppwszzDatabaseLocationList.
Valor devuelto
El valor devuelto es hrESULT. Un valor de S_OK indica que se ha realizado correctamente.
Comentarios
Los servicios de certificados deben ejecutarse para que este método se realice correctamente.
El nombre de esta función en Certadm.dll es CertSrvRestoreGetDatabaseLocationsW. Debe usar este formato del nombre al llamar a GetProcAddress. Además, esta función se define como tipo FNCERTSRVRESTOREGETDATABASELOCATIONSW en el archivo de encabezado Certbcli.h.
Ejemplos
FNCERTSRVRESTOREGETDATABASELOCATIONSW* pfnGetDBLocs;
char * szGetDBLocsFunc = "CertSrvRestoreGetDatabaseLocationsW";
WCHAR * pwszzDBLocs;
DWORD nListBytes=0;
HRESULT hr=0;
// Get the address for the desired function.
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnGetDBLocs = (FNCERTSRVRESTOREGETDATABASELOCATIONSW*)
GetProcAddress(hInst, szGetDBLocsFunc);
if ( NULL == pfnGetDBLocs )
{
printf("Failed GetProcAddress - %s, error=%d\n",
szGetDBLocsFunc,
GetLastError() );
exit(1); // Or other appropriate error action.
}
// Determine the names of the database locations.
// hCSBC was set by an earlier call to CertSrvRestorePrepare.
hr = pfnGetDBLocs(hCSBC, &pwszzDBLocs, &nListBytes);
if (FAILED(hr))
{
printf("Failed pfnGetDBLocs call [%x]\n", hr);
exit(1); // Or other appropriate error action.
}
else
{
printf("%d bytes for DB locations\n", nListBytes);
WCHAR * pwszFile = pwszzDBLocs;
// Process the list.
while ( L'\0' != *pwszFile )
{
// Use the file name referenced by pwszFile.
// Here it is merely displayed.
printf("%02x: %ws\n", *pwszFile, &pwszFile[1]);
// Move to the next database file name.
// + 1 moves past the null terminator.
pwszFile+=(wcslen(pwszFile)) + 1;
}
// Free the allocated memory.
// pfnBackupFree is the address of the
// CertSrvBackupFree function.
pfnBackupFree(pwszzDBLocs);
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | No se admite ninguno |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | certbcli.h (incluya Certsrv.h) |
| Library | Certadm.lib |
| Archivo DLL | Certadm.dll |
Consulte también
Uso de las funciones de copia de seguridad y restauración de Servicios de certificados