CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION
構造体サイズ=各フィールドのバイト数(x64/x86 で異なる場合は x64/x86 と併記)。x64/x86 列=フィールドのバイトオフセット(HSPで dupptr / lpoke / wpoke 等に使用)。
フィールド
| フィールド | 型 | サイズ | x64 | x86 | 説明 |
|---|---|---|---|---|---|
| ulAuthenticationPackage | DWORD | 4 | +0 | +0 | 認証パッケージの一意識別子です。このパラメーターは LsaLogonUser を呼び出すときに必須です。資格情報 UI のシナリオでは、シリアル化されたデータが SetSerialization を通じて送信される前に、この値が設定されます。これは LsaLookupAuthenticationPackage が返す認証パッケージの値と同じです。コンテンツ プロバイダーは、このパラメーターを使用して、この認証パッケージ向けの資格情報を返せるかどうかを判断できます。独自の認証パッケージを作成する開発者は、独自の値を指定できます。 |
| clsidCredentialProvider | GUID | 16 | +4 | +4 | 資格情報プロバイダーの CLSID です。資格情報プロバイダーは、シリアル化の際にこのメンバーに自身の CLSID を設定します。資格情報 UI はこのメンバーを無視します。 |
| cbSerialization | DWORD | 4 | +20 | +20 | rgbSerialization が指す資格情報のサイズ (バイト単位) です。 |
| rgbSerialization | BYTE* | 8/4 | +24 | +24 | シリアル化された資格情報の情報を格納するバイト配列です。このデータの正確な形式は、資格情報プロバイダーが対象とする認証パッケージによって異なります。 |
公式ドキュメント
資格情報に関する詳細を格納します。
解説(Remarks)
ユーザーが資格情報タイルに資格情報を入力した後は、その情報をバッファーに格納する必要があります。この情報をまとめる処理はシリアル化と呼ばれ、ログオン UI と資格情報 UI のどちらを使用するシナリオであっても必要です。CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION は、シリアル化のための構造を定義します。シリアル化の後、バッファーの送信先は、ログオン UI のシナリオか資格情報 UI のシナリオかによって異なります。ログオン UI では、バッファーは Winlogon に渡されます。資格情報 UI のシナリオでは、このバッファーは呼び出し元のアプリケーションに返され、アプリケーションはそれを使用してユーザーを認証します。
CPUS_LOGON の CREDENTIAL_PROVIDER_USAGE_SCENARIO を実装している場合でも、LsaLogonUser を直接呼び出すことはありません。この呼び出しはシステムが処理します。資格情報を Winlogon に渡すだけで済みます。
入力資格情報にはさまざまな形式があります。資格情報プロバイダーは、シリアル化された資格情報を受け取る際に堅牢であることが重要です。これには、不完全な資格情報や部分的な資格情報も含まれます。多くの場合、不完全な入力資格情報は、呼び出し元がどのような種類の資格情報を求めているかを示すヒントになります。この処理が使用される例の 1 つは、ユーザーからスマート カードの資格情報のみを収集しようとする呼び出し元の場合です。CPUS_LOGON の使用シナリオでは、システムは SetSerialization を使用して、リモート コンピューターからの情報の一部を設定します。ログオン UI は、列挙サイクルごとに SetSerialization を 0 回または 1 回呼び出します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)
各言語での定義
#include <windows.h>
// CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION (x64 32 / x86 28 バイト)
typedef struct CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION {
DWORD ulAuthenticationPackage;
GUID clsidCredentialProvider;
DWORD cbSerialization;
BYTE* rgbSerialization;
} CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION;using System;
using System.Runtime.InteropServices;
[StructLayout(LayoutKind.Sequential, CharSet = CharSet.Unicode)]
public struct CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION
{
public uint ulAuthenticationPackage;
public Guid clsidCredentialProvider;
public uint cbSerialization;
public IntPtr rgbSerialization;
}Imports System.Runtime.InteropServices
<StructLayout(LayoutKind.Sequential, CharSet:=CharSet.Unicode)>
Public Structure CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION
Public ulAuthenticationPackage As UInteger
Public clsidCredentialProvider As Guid
Public cbSerialization As UInteger
Public rgbSerialization As IntPtr
End Structureimport ctypes
from ctypes import wintypes
class CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION(ctypes.Structure):
_fields_ = [
("ulAuthenticationPackage", wintypes.DWORD),
("clsidCredentialProvider", GUID),
("cbSerialization", wintypes.DWORD),
("rgbSerialization", ctypes.c_void_p),
]#[repr(C)]
pub struct CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION {
pub ulAuthenticationPackage: u32,
pub clsidCredentialProvider: GUID,
pub cbSerialization: u32,
pub rgbSerialization: *mut core::ffi::c_void,
}import "golang.org/x/sys/windows"
type CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION struct {
ulAuthenticationPackage uint32
clsidCredentialProvider windows.GUID
cbSerialization uint32
rgbSerialization uintptr
}type
CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION = record
ulAuthenticationPackage: DWORD;
clsidCredentialProvider: TGUID;
cbSerialization: DWORD;
rgbSerialization: Pointer;
end;const CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION = extern struct {
ulAuthenticationPackage: u32,
clsidCredentialProvider: GUID,
cbSerialization: u32,
rgbSerialization: ?*anyopaque,
};type
CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION {.bycopy.} = object
ulAuthenticationPackage: uint32
clsidCredentialProvider: GUID
cbSerialization: uint32
rgbSerialization: pointerstruct CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION
{
uint ulAuthenticationPackage;
GUID clsidCredentialProvider;
uint cbSerialization;
void* rgbSerialization;
}HSP用 定義
HSP3.7/3.8 は構造体機能が無いため4byte整数配列(dim)+peek/poke で操作(32/64bitでサイズ・位置が異なる場合はタブで分割)。IronHSP は NSTRUCT(#defstruct/stdim/->)で32/64bit共通。
; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x86 レイアウト)
; CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION サイズ: 28 バイト(x86)
dim st, 7 ; 4byte整数×7(構造体サイズ 28 / 4 切り上げ)
; ulAuthenticationPackage : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; clsidCredentialProvider : GUID (+4, 16byte) varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; cbSerialization : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; rgbSerialization : BYTE* (+24, 4byte) st.6 = 値 / 値 = st.6 (lpoke/lpeek も可)
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; HSP3.7/3.8 は構造体機能が無いため、4byte整数の配列変数で操作します。(x64 レイアウト)
; CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION サイズ: 32 バイト(x64)
dim st, 8 ; 4byte整数×8(構造体サイズ 32 / 4 切り上げ)
; ulAuthenticationPackage : DWORD (+0, 4byte) st.0 = 値 / 値 = st.0 (lpoke/lpeek も可)
; clsidCredentialProvider : GUID (+4, 16byte) varptr(st)+4 を基点に操作(16byte:入れ子/配列)
; cbSerialization : DWORD (+20, 4byte) st.5 = 値 / 値 = st.5 (lpoke/lpeek も可)
; rgbSerialization : BYTE* (+24, 8byte) qpoke st,24,値 / qpeek(st,24) ※IronHSPのみ。3.7/3.8は lpoke st,24,下位 : lpoke st,28,上位
; ※4byte境界の整数は添字 st.N(N=オフセット/4)で読み書き可。それ以外は peek/poke 系を使用。; IronHSP は NSTRUCT(構造体)をサポート。32bit/64bit どちらでも同じコードで動作します。
; ※GUID・入れ子構造体はデフォルト型でないため、依存する #defstruct を先に定義(下記に同梱)。
#defstruct global GUID, pack=1
#field int Data1
#field short Data2
#field short Data3
#field byte Data4 8
#endstruct
#defstruct global CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION
#field int ulAuthenticationPackage
#field GUID clsidCredentialProvider
#field int cbSerialization
#field intptr rgbSerialization
#endstruct
stdim st, CREDENTIAL_PROVIDER_CREDENTIAL_SERIALIZATION ; NSTRUCT 変数を確保
st->ulAuthenticationPackage = 100
mes "ulAuthenticationPackage=" + st->ulAuthenticationPackage