Expand Minimize
This topic has not yet been rated - Rate this topic

LsaManageSidNameMapping function

The LsaManageSidNameMapping function adds or removes SID/name mappings from the mapping set registered with the LSA Lookup Service.

Syntax


void WINAPI LsaManageSidNameMapping(
  _In_   LSA_SID_NAME_MAPPING_OPERATION_TYPE OpType,
  _In_   PLSA_SID_NAME_MAPPING_OPERATION_INPUT OpInput,
  _Out_  PLSA_SID_NAME_MAPPING_OPERATION_OUTPUT *OpOutput
);

Parameters

OpType [in]

Indicates if a this function is being called to add or remove an SID/name mapping.

OpInput [in]

Indicates the domain, account, and SID values to use during this operation. Additional flags can also be set within this structure.

OpOutput [out]

Provides extended error information when indicating operation success or failure.

ValueMeaning
Success

Operation is complete without error.

NonMappingError

An error unrelated to SID-name mapping has occurred.

NameCollision

Operation failure due to name collision.

SidCollision

Operation failure due to SID collision.

DomainNotFound

Corresponding domain not found.

DomainSidPrefixMismatch

Provided SID doesn't have the correct domain prefix.

MappingNotFound

Mapping not found in the cache.

 

Return value

If the mapping is inserted successfully, the return value is STATUS_SUCCESS. Otherwise, if the function fails due to SID or name conflicts, STATUS_INVALID_PARAMETER error will be returned.

Note  

Extended error information is provided via the OpOutput parameter.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Ntsecapi.h

Library

Secur32.lib

DLL

Secur32.dll

 

 

Send comments about this topic to Microsoft

Build date: 1/2/2013

Community Additions

ADD
© 2013 Microsoft. All rights reserved.