Método IVdsServiceIscsi::SetInitiatorSharedSecret (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.]
Define o segredo compartilhado CHAP do iniciador que é usado para autenticação CHAP mútua quando o iniciador autentica o destino.
Sintaxe
HRESULT SetInitiatorSharedSecret(
[in] VDS_ISCSI_SHARED_SECRET *pInitiatorSharedSecret,
[in] VDS_OBJECT_ID targetId
);
Parâmetros
[in] pInitiatorSharedSecret
O endereço de uma estrutura VDS_ISCSI_SHARED_SECRET que contém o segredo compartilhado. Se o membro pSharedSecret for NULL e ulSharedSecretSize for zero, o método SetInitiatorSharedSecret limpará qualquer segredo existente. Se esse parâmetro for NULL e o parâmetro targetId não for GUID_NULL, SetInitiatorSharedSecret limpará a associação entre o iniciador e o destino.
[in] targetId
O VDS_OBJECT_ID do destino. Esse parâmetro será definido como GUID_NULL se o segredo compartilhado não for específico do destino.
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 ser originados do próprio VDS ou do provedor de VDS subjacente que está sendo usado. Os possíveis valores retornados incluem o seguinte.
| Código/valor de retorno | Descrição |
|---|---|
|
O segredo compartilhado foi definido com êxito. |
|
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. |
|
O serviço iniciador não dá suporte à configuração de segredos compartilhados específicos do destino. |
Comentários
Um iniciador pode dar suporte à configuração de um segredo compartilhado CHAP diferente para cada destino.
Não há como determinar programaticamente se um iniciador dá suporte a segredos específicos de destino. Se a chamada para SetInitiatorSharedSecret retornar VDS_E_TARGET_SPECIFIC_NOT_SUPPORTED, chame o método novamente, definindo o parâmetro targetId como GUID_NULL.
O Iniciador de Software iSCSI da Microsoft não dá suporte à configuração de segredos específicos do destino.
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