[This function is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Beginning with Windows Vista, use Volume Shadow Copy Service (VSS) instead.]
The DsSetAuthIdentity function sets the security context under which the directory backup APIs are called.
Syntax
HRESULT DsSetAuthIdentity(
_In_ LPCTSTR szUserName,
_In_ LPCTSTR szDomainName,
_In_ LPCTSTR szPassword
);
Parameters
szUserName [in]
The null-terminated string that specifies the user name.
szDomainName [in]
The null-terminated string that specifies the name of the domain that the user belongs to.
szPassword [in]
The null-terminated string that specifies the password of the user in the specified domain.
Return value
If successful, returns a standard HRESULT success codes; otherwise, a failure code is returned.
Remarks
If DsSetAuthIdentity is not called, security context of the current process is assumed.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Minimum supported server | Windows Server 2008 |
| Header | Ntdsbcli.h |
| Library | Ntdsbcli.lib |
| DLL | Ntdsbcli.dll |
| Unicode and ANSI names | DsSetAuthIdentityW (Unicode) and DsSetAuthIdentityA (ANSI) |
See also
Backing Up and Restoring an Active Directory Server
Source: Microsoft Learn / Windows Win32 documentation by Microsoft and contributors. Documentation licensed CC BY 4.0. Code samples are covered by the MIT License. Converted from Markdown, with links normalized and embedded media omitted.
