Función CertSrvBackupOpenFileW (certbcli.h)

La función CertSrvBackupOpenFile abre un archivo para la copia de seguridad.

Sintaxis

HRESULT CERTBCLI_API CertSrvBackupOpenFileW(
  [in]  HCSBC         hbc,
  [in]  WCHAR const   *pwszAttachmentName,
  [in]  DWORD         cbReadHintSize,
  [out] LARGE_INTEGER *pliFileSize
);

Parámetros

[in] hbc

Identificador de un contexto de copia de seguridad de Servicios de certificados.

[in] pwszAttachmentName

Nombre de archivo que se va a abrir con fines de copia de seguridad. Este nombre de archivo se analizaría a partir de una lista generada por medio de CertSrvBackupGetBackupLogs o CertSrvBackupGetDatabaseNames. Tenga en cuenta que los nombres devueltos por CertSrvBackupGetBackupLogs y CertSrvBackupGetDatabaseNames deben tener quitado el prefijo WCHAR único CSBFT_* antes de llamar a CertSrvBackupOpenFile .

[in] cbReadHintSize

Número de bytes usados como sugerencia cuando CertSrvBackupRead lee el archivo. El parámetro cbReadHintSize pasado a la primera llamada CertSrvBackupOpenFile para el contexto de copia de seguridad se usa para ajustar el tamaño del búfer de lectura. Pase cero para este parámetro y el búfer se ajustará a un tamaño razonablemente eficaz elegido por CertSrvBackupOpenFile. Si no hay suficiente memoria disponible, el tamaño del búfer se reducirá hasta que la asignación de memoria se realice correctamente o hasta que el tamaño del búfer alcance su valor mínimo posible. Pase un tamaño distinto de cero para que CertSrvBackupOpenFile dimensione el búfer a una potencia de dos cerca del valor de cbReadHintSize. La implementación solo elegirá potencias de dos entre 64 KB y 4 MB.

[out] pliFileSize

Puntero a un valor de LARGE_INTEGER que representa el número de bytes del archivo.

Valor devuelto

Si la función se realiza correctamente, la función devuelve S_OK.

Si se produce un error en la función, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Use esta función para abrir un archivo con fines de copia de seguridad. Cuando haya terminado de usar el archivo, cierre el archivo llamando a la función CertSrvBackupClose .

El nombre de esta función en Certadm.dll es CertSrvBackupOpenFileW. Debe usar este formato del nombre al llamar a GetProcAddress. Además, esta función se define como tipo FNCERTSRVBACKUPOPENFILEW en Certbcli.h.

Ejemplos

FNCERTSRVBACKUPOPENFILEW* pfnOpenFile;
char * szBackupOpenFunc = "CertSrvBackupOpenFileW";
LARGE_INTEGER liFileSize;
HRESULT       hr=0;

// Get the address for the desired function.    
// hInst was set by calling LoadLibrary for Certadm.dll.
pfnOpenFile = (FNCERTSRVBACKUPOPENFILEW*)GetProcAddress(hInst,
                                         szBackupOpenFunc);
if ( NULL == pfnOpenFile )
{
    printf("Failed GetProcAddress - %s, error=%d\n",
            szBackupOpenFunc,
            GetLastError() );
    exit(1); // or other appropriate error action
}

// Open the file.
// hCSBC was set by an earlier call to CertSrvBackupPrepare.
// pwszFile specifies the name of a file.
// This name could have resulted from parsing the
// output from CertSrvBackupGetDatabaseNames, and so on.
hr = pfnOpenFile(hCSBC,
                pwszFile,
                0,
                &liFileSize);
if (FAILED(hr))
{
    printf("Failed pfnOpenFile call [%x] %ws\n",
           hr,
           pwszFile);
           exit(1); // Or other appropriate error action.
}

// Use the opened file as needed.
// When you have finished using the file, call CertSrvBackupClose.
// ...

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

CertSrvBackupClose

CertSrvBackupRead

Uso de las funciones de copia de seguridad y restauración de Servicios de certificados