GetSecurityDescriptor Method

  • Article

The GetSecurityDescriptor method returns the security descriptor for the URL item.

Syntax
HRESULT GetSecurityDescriptor(
  BYTE*pSD,
  DWORDdwSize,
  DWORD*pdwLength);
Parameters
  • pSD
    [out, size_is(dwSize)] Pointer to a BYTE that contains information about the security descriptor used for this content source.
  • dwSize
    [in] Pointer to a DWORD that contains the size of the pSD buffer.
  • pdwLength
    [out] Pointer to a DWORD that contains the number of bytes written to the pSD buffer.
Return Value

For a list of error messages returned by SharePoint Portal Server Protocol Handlers, see Error Messages.

Remarks

The GetSecurityDescriptor retrieves the security information associated with the URL item. If this method is not implemented, the item will be retrievable by all user queries. This method also allows custom mappings between users registered to a content source and those users registered on the domain, if they are different. Security descriptors created in this method must be self-relative.

The Microsoft Platform SDK provides complete information about designing and creating Security Descriptors for the Windows 2000. For more information about Security Descriptors, see the Security section of the Platform SDK.

Example

To see this method in a fuller context, see Protocol Handler Sample.