IsDeviceRegisteredWithManagement 関数 (mdmregistration.h)

デバイスが MDM サービスに登録されているかどうかを確認します。 デバイスが登録されている場合は、登録済みユーザーのユーザー プリンシパル名 (UPN) も返されます。

構文

HRESULT IsDeviceRegisteredWithManagement(
  [out]           BOOL   *pfIsDeviceRegisteredWithManagement,
  [in, optional]  DWORD  cchUPN,
  [out, optional] LPWSTR pszUPN
);

パラメーター

[out] pfIsDeviceRegisteredWithManagement

BOOL のアドレスは、デバイスが登録されているかどうかを示します。

[in, optional] cchUPN

pszUPN パラメーターを使用して返すことができる最大長を格納します。

[out, optional] pszUPN

管理サービスに登録されているユーザーの UPN を含む NULL で終わる Unicode 文字列を受け取るバッファーの省略可能なアドレス。 pszUPN が NULL の場合、pfIsDeviceRegisteredWithManagement パラメーターが指す BOOL が更新され、デバイスが登録され、関数がERROR_SUCCESSを返すかどうかを示します。

戻り値

関数が成功した場合、戻り値はERROR_SUCCESSされ、pfIsDeviceRegisteredWithManagement パラメーターによって指される BOOL には TRUE または FALSE が含まれます。 TRUE の場合、pszUPN パラメーターが指す Unicode 文字列には、登録済みユーザーの UPN が含まれます。 関数が失敗した場合、返される値はエラーを記述します。 使用できる値には、「 MDM 登録エラー値」に記載されているものがあります。

cchUPN パラメーターによって示されるバッファー サイズが小さすぎる場合、呼び出しは STRSAFE_E_INSUFFICIENT_BUFFER で失敗しますが、pfIsDeviceRegisteredWithManagement パラメーターによって指される BOOL は更新され、デバイスが登録されているかどうかを示します。

要件

関連項目

MDM 登録エラー値

MDM 登録関数