LSA_CRACK_SINGLE_NAME回呼函式 (ntsecpkg.h)
CrackSingleName 函式會將名稱從一種格式轉換成另一種格式。
語法
LSA_CRACK_SINGLE_NAME LsaCrackSingleName;
NTSTATUS LsaCrackSingleName(
[in] ULONG FormatOffered,
[in] BOOLEAN PerformAtGC,
[in] PUNICODE_STRING NameInput,
[in, optional] PUNICODE_STRING Prefix,
[in] ULONG RequestedFormat,
[out] PUNICODE_STRING CrackedName,
[out] PUNICODE_STRING DnsDomainName,
[out] PULONG SubStatus
)
{...}
參數
[in] FormatOffered
輸入名稱的格式。 下表包含此參數的有效值。
| 值 | 意義 |
|---|---|
|
完整標準名稱 (例如，example.microsoft.com/software/someone) 。 僅限網域版本包含結尾斜線 (/) 。 |
|
與DS_CANONICAL_NAME相同，除了最右邊的斜線 (/) 會取代為換行符 (\n) ，即使在僅限網域的情況下 (，例如，example.microsoft.com/software\n某人) 。 |
|
「易記」顯示名稱。 顯示名稱不一定是定義 相對辨別名稱 (RDN) 。 |
|
完整辨別名稱 (例如 CN=NameOfPerson，OU=Users，DC=Example，DC=Fabrikam，DC=Com) 。 |
|
例如，Windows 帳戶名稱 (Example\Name) 。 僅限網域版本包含尾端反斜杠 (\\) 。 |
|
一般化 服務主體名稱 (例如 www/www.microsoft.com@microsoft.com) 。 |
|
對象 的安全性標識碼 (SID) 。 這可以是物件 SID 歷程記錄中的目前 SID 或 SID。 SID 字串可以使用 SID 的標準字串表示，或 Sddl.h 中定義的其中一個字串常數。 如需將二進位SID轉換成 SID 字串的相關信息，請參閱 SID 字串。 這個值對 formatDesired 參數無效。 |
|
IIDFromString 函式傳回 (的 GUID 字串，例如 {4fa050f0-f561-11cf-bdd9-00aa003a77b6}) 。 |
|
未知的名稱類型。 |
|
例如，使用者主體名稱 () someone@example.microsoft.com 。 |
[in] PerformAtGC
指定是否要在全域編錄伺服器上執行翻譯。
[in] NameInput
包含要轉換之名稱 之UNICODE_STRING 結構的指標。
[in, optional] Prefix
指定名稱前置詞 之UNICODE_STRING 結構的指標。
[in] RequestedFormat
已破解名稱的要求格式。 如需有效值的清單，請參閱 FormatOffered 參數。
[out] CrackedName
接收重新格式化名稱 之UNICODE_STRING 結構的指標。
[out] DnsDomainName
UNICODE_STRING 結構的指標，該結構會接收擁有 NameInput 參數所指定名稱的功能變數名稱。
[out] SubStatus
變數的指標，可接收函數調用傳回值的其他資訊。
傳回值
如果函式成功，函式會傳回STATUS_SUCCESS。
如果函式失敗，它會傳回STATUS_UNSUCCESSFUL。 如需詳細資訊，請參閱 SubStatus 參數中傳回的值。
備註
在SpInitialize函式所接收的LSA_SECPKG_FUNCTION_TABLE結構中，有一個指向 CrackSingleName 函式的指標。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | ntsecpkg.h |