Compartilhar via


Método IVdsServiceIscsi::RememberTargetSharedSecret (vds.h)

[Começando com Windows 8 e Windows Server 2012, a interface COM do Serviço de Disco Virtual é substituída pela API de Gerenciamento de Armazenamento do Windows.]

Comunica o segredo compartilhado CHAP de um destino para o serviço iniciador. Esse segredo compartilhado é usado durante o logon de destino quando o destino autentica o iniciador.

Sintaxe

HRESULT RememberTargetSharedSecret(
  [in] VDS_OBJECT_ID           targetId,
  [in] VDS_ISCSI_SHARED_SECRET *pTargetSharedSecret
);

Parâmetros

[in] targetId

O VDS_OBJECT_ID do destino que tem o segredo compartilhado especificado. Esse parâmetro é necessário e não pode ser GUID_NULL.

[in] pTargetSharedSecret

O endereço de uma estrutura VDS_ISCSI_SHARED_SECRET que contém o segredo compartilhado CHAP.

Retornar valor

Esse método pode retornar valores HRESULT padrão, como E_INVALIDARG ou E_OUTOFMEMORY, e valores retornados específicos do VDS. Ele também pode retornar códigos de erro do sistema convertidos usando a macro HRESULT_FROM_WIN32 . Os erros podem se originar do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.

Retornar código/valor Descrição
S_OK
O segredo compartilhado foi lembrado com êxito.
VDS_E_INITIALIZED_FAILED
0x80042401L
Falha ao inicializar o VDS. Se um aplicativo chamar esse método antes que o serviço termine de inicializar, o método será bloqueado até que a inicialização seja concluída. Se a inicialização falhar, esse erro será retornado.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vds.h
Biblioteca Uuid.lib
Redistribuível VDS 1.1

Confira também

IVdsIscsiTarget::RememberInitiatorSharedSecret

IVdsIscsiTarget::SetSharedSecret

IVdsServiceIscsi

IVdsServiceIscsi::SetInitiatorSharedSecret

VDS_ISCSI_SHARED_SECRET