Share via

XtfGetCredentialInfoCount

  • Article

Gets the count of credentials stored in an XtfNetworkCredentials object returned by XtfGetCredentialInfoList.

Syntax

HRESULT XtfGetCredentialInfoCount(
         XtfNetworkCredentials credentialInfo,
         UINT32* count
)

Parameters

credentialInfo
Type: XtfNetworkCredentials

[in] An XtfNetworkCredentials object created by calling XtfGetCredentialInfoList.

count
Type: UINT32*

[out] The number of credentials stored in credentialInfo.

Return value

Type: HRESULT

Returns S_OK if successful; otherwise, returns an HRESULT error code.

Remarks

Use this function to get the number of credentials stored in the XtfNetworkCredentials object returned by the XtfGetCredentialInfoList function. Use this function with the XtfGetCredentialInfoList, XtfGetCredentialServerName, and XtfGetCredentialUserName functions to enumerate the current list of stored credentials on a console. You can also use XtfAddCredential to add credentials and XtfRemoveCredential to remove credentials.

When you're done, use XtfCloseCredentialInfoList to free the XtfNetworkCredentials object returned by XtfGetCredentialInfoList.

For an example that demonstrates how to manage and enumerate stored credentials, see XtfGetCredentialInfoList.

Requirements

Header: xtfapi.h

Library: XtfApi.lib

Supported platforms: Windows (for Xbox console tools)

See also

Run from PC Deployment (NDA topic)
XTF Transport Errors (NDA topic)
Additional Xtf APIs