Compartilhar via

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE função de retorno de chamada (d3d10umddi.h)

  • Artigo

Estabelece uma chave de sessão para um objeto de sessão criptográfica.

Sintaxe

PFND3D11_1DDI_NEGOTIATECRYPTOSESSIONKEYESCHANGE Pfnd3d111DdiNegotiatecryptosessionkeyeschange;

HRESULT Pfnd3d111DdiNegotiatecryptosessionkeyeschange(
  D3D10DDI_HDEVICE hDevice,
  D3D11_1DDI_HCRYPTOSESSION hCryptoSession,
  UINT DataSize,
  BYTE *pData
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

hCryptoSession

Um identificador para o objeto de sessão criptográfica que foi criado por meio de uma chamada para a função CreateCryptoSession .

DataSize

O tamanho, em bytes, dos dados na matriz pData .

pData

Um ponteiro para uma matriz de bytes que contém a chave de sessão criptografada.

Retornar valor

NegotiateCryptoSessionKeyExchange retorna um dos seguintes valores:

Código de retorno Descrição
S_OK A chave de sessão para a sessão criptográfica foi negociada com êxito.
E_INVALIDARG Os parâmetros foram validados e determinados como incorretos.
E_OUTOFMEMORY A memória não estava disponível para concluir a operação.

Comentários

O parâmetro pData faz referência a um buffer que contém uma chave de sessão para a sessão criptográfica. O mecanismo de troca de chaves depende do tipo do algoritmo de criptografia usado pela sessão criptográfica.

Para sessões que usam o algoritmo RSA ENCRYPTION Scheme – Preenchimento de Criptografia Assimétrica Ideal (RSAES-OAEP), o buffer de chave deve conter 256 bytes de dados e deve ser criptografado usando o algoritmo RSA Encryption Scheme – Preenchimento de Criptografia Assimétrica Ideal (RSAES-OAEP) com a chave pública do certificado de sessão criptográfica.

A troca de chaves para uma sessão criptográfica é idêntica à troca de chaves para a interface do OPM (Gerenciador de Proteção de Saída). No entanto, o buffer de chave OPM contém dados adicionais além da chave de sessão.

Nota O mesmo certificado pode ser usado para a sessão criptográfica e a chave de sessão OPM.
 

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8
Servidor mínimo com suporte Windows Server 2012
Plataforma de Destino Área de Trabalho
Cabeçalho d3d10umddi.h (inclua D3d10umddi.h)

Confira também

CreateCryptoSession