函数功能

函数原型

返回值

举例

函数功能

创建一个SID（安全描述符）

函数原型

BOOL WINAPI CreateWellKnownSid( __in WELL_KNOWN_SID_TYPE WellKnownSidType, __in_opt PSID DomainSid, __out_opt PSID pSid, __inout DWORD *cbSid);

参数：

WellKnownSidType SID类型，WELL_KNOWN_SID_TYPE是枚举类型，它包含一系列的安全描述符类型

DomainSid 指向创建了SID的域的指针，为NULL时表示使用本地计算机

pSid 指向存储SID的地址

cbSid 指向存储pSid的大小的地址

返回值

函数成功执行，返回非0的值；

执行失败，返回值为0。想进一步了解错误信息，执行GetLastError.

举例

DWORD SidSize;

PSID TheSID;

LPTSTR p;

SidSize = SECURITY_MAX_SID_SIZE; // 申请大足够的内存

if(!(TheSID = LocalAlloc(LMEM_FIXED, SidSize))){

fprintf(stderr, "Could not allocate memory.\");

exit(1);

} //为计算机上的每一个组创建一个安全描述符

if(!CreateWellKnownSid(WinWorldSid, NULL, TheSID, &SidSize)){

fprintf(stderr, "CreateWellKnownSid Error %u", GetLastError());

}

else{ // 获得安全描述符版本号 (S-1-1-0).

if(!(ConvertSidToStringSid(TheSID, &p))) {

fprintf(stderr, "Error during ConvertSidToStringSid.\");

exit(1);

} // 当需要的时候使用安全描述符字符串

// ...

// 完成工作，释放内存

LocalFree(p);

LocalFree(TheSID);

}