NDdeGetShareSecurity-Funktion

[Netzwerk-DDE wird nicht mehr unterstützt. Nddeapi.dll ist unter Windows Vista vorhanden, aber alle Funktionsaufrufe geben NDDE_NOT_IMPLEMENTED zurück.]

Ruft den Sicherheitsdeskriptor ab, der der DDE-Freigabe zugeordnet ist. Dies erfolgt in der Regel für die Bearbeitung.

Syntax

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

Parameter

lpszServer [in]

Der Name des Servers, auf dem sich der DSDM befindet.

lpszShareName [in]

Der Name der Freigabe, deren Sicherheitsbeschreibung aus dem DSDM abgerufen werden soll. Dieser Parameter darf nicht NULL sein.

si [in]

Ein SECURITY_INFORMATION Wert, der die Sicherheitsinformationen angibt, die aus dem der Freigabe zugeordneten Sicherheitsdeskriptor abgerufen werden sollen.

pSD [out]

Ein Zeiger auf eine SECURITY_DESCRIPTOR-Struktur , die den selbstrelativen Sicherheitsdeskriptor empfängt. Dieser Parameter kann NULL sein. Wenn dieser Parameter NULL ist, bestimmt der DSDM die Größe der angeforderten Sicherheitsinformationen und gibt die Anzahl der Bytes zurück, die im Parameter lpcbsdRequired zusammen mit dem NDDE_BUF_TOO_SMALL Fehlercode benötigt werden.

cbSD [in]

Die Größe des pSD-Puffers . Dieser Parameter muss null sein, wenn pSDNULL ist.

lpcbsdRequired [out]

Ein Zeiger auf die Variable, die die tatsächliche Größe des abgerufenen Sicherheitsdeskriptors empfängt. Dieser Parameter darf nicht NULL sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NDDE_NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Fehlercode, der durch Aufrufen von NDdeGetErrorString in eine Textfehlermeldung übersetzt werden kann. Wenn der pSD-ParameterNULL ist, wird NDDE_BUF_TOO_SMALL zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Header	Nddeapi.h
Bibliothek	Nddeapi.lib
DLL	Nddeapi.dll
Unicode- und ANSI-Name	NDdeGetShareSecurityW (Unicode) und NDdeGetShareSecurityA (ANSI)

Weitere Informationen

Übersicht über den dynamischen Netzwerkdatenaustausch

Netzwerk-DDE-Funktionen

SECURITY_INFORMATION

NDdeSetShareSecurity