Compartir a través de


Función NCryptStreamUpdate (ncryptprotect.h)

La función NCryptStreamUpdate cifra y descifra bloques de datos.

Sintaxis

SECURITY_STATUS NCryptStreamUpdate(
  [in] NCRYPT_STREAM_HANDLE hStream,
  [in] const BYTE           *pbData,
       SIZE_T               cbData,
       BOOL                 fFinal
);

Parámetros

[in] hStream

Controle el objeto de secuencia creado llamando a NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect.

[in] pbData

Puntero a la matriz de bytes que se va a procesar.

cbData

Número de bytes de la matriz binaria especificada por el parámetro pbData .

fFinal

Valor booleano que especifica si se ha procesado el último bloque de datos.

Valor devuelto

Devuelve un código de estado que indica el éxito o error de la función. Entre los códigos de retorno posibles se incluyen, entre otros, los siguientes.

Código devuelto Descripción
ERROR_SUCCESS
La función se realizó correctamente.
NTE_BAD_DATA
No se pudo descodificar el contenido.
NTE_INVALID_HANDLE
El identificador de secuencia al que apunta el parámetro hStream no es válido.
NTE_NO_MEMORY
No había memoria suficiente disponible para procesar el contenido.

Comentarios

Debe llamar a NCryptStreamOpenToProtect o NCryptStreamOpenToUnprotect para abrir una secuencia antes de llamar a NCryptStreamUpdate.

Los mensajes pueden ser tan grandes que procesarlos a la vez almacenando todo el mensaje en la memoria puede ser difícil. Sin embargo, es posible procesar mensajes de gran tamaño mediante la creación de particiones de los datos que se van a procesar en bloques administrables.

Para ello, use NCryptStreamUpdate en un bucle que avanza a través del bloque de archivos por bloque. A medida que se procesa el mensaje transmitido, los datos de salida resultantes se devuelven a la aplicación mediante una función de devolución de llamada que especifique. Esto se muestra en el siguiente ejemplo. Para obtener más información sobre la función de devolución de llamada, consulte PFNCryptStreamOutputCallback.

Nota Se recomienda usar demasiado pequeño de un tamaño de bloque. Los bloques pequeños requieren más llamadas y, por tanto, más sobrecarga de llamadas. Además, las API de streaming están optimizadas para bloques más grandes. Debe experimentar para encontrar el mejor tamaño de bloque para los datos que debe procesar.
 
BOOL                        fFinal = FALSE;
PBYTE                       pbBuf = NULL;

// Determine the number of bytes to read.
DWORD cbData = GetFileSize( hFileIn, NULL );

// Call NCryptStreamUpdate while there is data left to read.
while(FALSE == fFinal)
{
    // Read dwBlockSize bytes from the file.
    if(dwBlockSize > 1)
    {
        if( !ReadFile(hFileIn, pbBuf, dwBlockSize, &cbResult, NULL) )
        {
            hr = HRESULT_FROM_WIN32(hr);            
            goto CleanUp;
        }
    }

    // Decrement the number of bytes to read by the current amount read.
    cbData -= cbResult;

    // Set fFinal if there are no bytes left to read.
    if (cbData <= 0) fFinal = TRUE;

    // Encrypt (or decrypt) the bytes pointed to by pbBuf
    hr = NCryptStreamUpdate(hStream, pbBuf, cbResult, fFinal); 
    if( FAILED(hr) )
    {            
        goto CleanUp;
    }         
}      

CleanUp:
    if( NULL != hStream )
    {
        NCryptStreamClose(hStream);
    }
    if( NULL != hDescriptor )
    {
        NCryptCloseProtectionDescriptor( hDescriptor );
    }
    if(NULL != pbBuf)
    {
        LocalFree(pbBuf);
        pbBuf = NULL;
    }

Requisitos

Requisito Value
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado ncryptprotect.h
Library NCrypt.lib
Archivo DLL NCrypt.dll

Consulte también

Funciones dpAPI de CNG

NCRYPT_PROTECT_STREAM_INFO

NCryptStreamOpenToProtect

NCryptStreamOpenToUnprotect