SO_WSK_SECURITY
SO_WSK_SECURITY通訊端選項可讓 WSK 應用程式將安全性描述項套用至通訊端，或從通訊端擷取通訊端安全性描述元的快取複本。 安全性描述項會控制通訊端所系結之本機傳輸位址的共用。
此通訊端選項僅適用于接聽通訊端、資料包通訊端和連接導向通訊端。
如果 WSK 應用程式使用此通訊端選項將安全性描述項套用至通訊端，它必須先這麼做，通訊端才會系結至本機傳輸位址。
若要將安全性描述項套用至通訊端，WSK 應用程式會使用下列參數呼叫 WskControlSocket 函式。
| 參數 | 值 |
|---|---|
RequestType |
WskSetOption |
ControlCode |
SO_WSK_SECURITY |
Level |
SOL_SOCKET |
InputSize |
sizeof (PSECURITY_DESCRIPTOR) |
InputBuffer |
PSECURITY_DESCRIPTOR型別變數的指標。 此變數必須包含使用WSK_CACHE_SD控制項程式碼呼叫WskControlClient函式來取得之安全描述元快取複本的指標。 |
OutputSize |
0 |
OutputBuffer |
NULL |
OutputSizeReturned |
NULL |
呼叫 WskControlSocket 函式時，WSK 應用程式必須指定 IRP 的指標，以將安全性描述項套用至通訊端。
如果 WSK 應用程式使用此通訊端選項將安全性描述項套用至通訊端，新的安全性描述元會取代先前套用至通訊端的任何安全性描述元。
在 IRP 完成之前，WSK 應用程式不得釋放安全描述元的快取複本。
WSK 應用程式也可以藉由在呼叫WskSocket或WskSocketConnect函式時，指定SecurityDescriptor參數中安全性描述元快取複本的指標，將安全性描述項套用至通訊端。
如果 WSK 應用程式未將安全性描述項套用至通訊端，WSK 子系統會使用不允許共用本機傳輸位址的預設安全性描述元。
若要從通訊端擷取通訊端安全性描述元的快取複本，WSK 應用程式會使用下列參數呼叫 WskControlSocket 函式。
| 參數 | 值 |
|---|---|
RequestType |
WskGetOption |
ControlCode |
SO_WSK_SECURITY |
Level |
SOL_SOCKET |
InputSize |
0 |
InputBuffer |
NULL |
OutputSize |
sizeof (PSECURITY_DESCRIPTOR) |
OutputBuffer |
PSECURITY_DESCRIPTOR型別變數的指標。 此變數會接收通訊端安全描述元快取複本的指標。 |
OutputSizeReturned |
NULL |
WSK 應用程式必須在呼叫 WskControlSocket 函式時指定 IRP 的指標，以從通訊端擷取通訊端的安全性描述元快取複本。
WSK 應用程式必須使用WSK_RELEASE_SD控制項程式碼呼叫WskControlClient函式，才能在不再需要時釋放安全性描述元的快取複本。
如需詳細資訊，請參閱 SECURITY_DESCRIPTOR 結構的參考頁面。
規格需求
版本 |
可在 Windows Vista 和更新版本的 Windows 作業系統中使用。 |
標頭 |
Wsk.h (包含 Wsk.h) |