Função NDdeGetShareSecurity

Artigo
06/13/2023

[O DDE de rede não tem mais suporte. Nddeapi.dll está presente no Windows Vista, mas todas as chamadas de função retornam NDDE_NOT_IMPLEMENTED.]

Recupera o descritor de segurança associado ao compartilhamento DDE. Isso geralmente é feito para edição.

Sintaxe

UINT NDdeGetShareSecurity(
  _In_  LPTSTR               lpszServer,
  _In_  LPTSTR               lpszShareName,
  _In_  SECURITY_INFORMATION si,
  _Out_ PSECURITY_DESCRIPTOR pSD,
  _In_  DWORD                cbSD,
  _Out_ LPDWORD              lpcbsdRequired
);

Parâmetros

lpszServer [in]: O nome do servidor no qual o DSDM reside.
lpszShareName [in]: O nome do compartilhamento cujo descritor de segurança deve ser recuperado do DSDM. Esse parâmetro não pode ser NULL.
si [in]: Um valor SECURITY_INFORMATION que especifica as informações de segurança a serem recuperadas do descritor de segurança associado ao compartilhamento.
pSD [out]: Um ponteiro para uma estrutura SECURITY_DESCRIPTOR que recebe o descritor de segurança auto-relativo. Este parâmetro pode ser NULL. Se esse parâmetro for NULL, o DSDM determinará o tamanho das informações de segurança solicitadas e retornará o número de bytes necessários no parâmetro lpcbsdRequired junto com o código de erro NDDE_BUF_TOO_SMALL.
cbSD [in]: O tamanho do buffer pSD . Esse parâmetro deverá ser zero se pSD for NULL.
lpcbsdRequired [out]: Um ponteiro para a variável que recebe o tamanho real do descritor de segurança recuperado. Esse parâmetro não pode ser NULL.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NDDE_NO_ERROR.

Se a função falhar, o valor retornado será um código de erro, que pode ser convertido em uma mensagem de erro de texto chamando NDdeGetErrorString. Se o parâmetro pSD for NULL, ele retornará NDDE_BUF_TOO_SMALL.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho	Nddeapi.h
Biblioteca	Nddeapi.lib
DLL	Nddeapi.dll
Nomes Unicode e ANSI	NDdeGetShareSecurityW (Unicode) e NDdeGetShareSecurityA (ANSI)

Confira também

Visão geral do Exchange de Dados Dinâmicos de Rede
Funções DDE de rede
SECURITY_INFORMATION
NDdeSetShareSecurity

Compartilhar via