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 |
|
| Bibliothek |
|
| DLL |
|
| Unicode- und ANSI-Name |
NDdeGetShareSecurityW (Unicode) und NDdeGetShareSecurityA (ANSI) |