ActiveDirectorySiteLink.FindByName 메서드

정의

사이트 링크 이름에 따라 사이트 링크를 반환합니다.Returns a site link based on a site link name.

오버로드

FindByName(DirectoryContext, String, ActiveDirectoryTransportType)

사이트 링크 이름과 전송에 따라 사이트 링크를 반환합니다.Returns a site link based on a site link name and transport.

FindByName(DirectoryContext, String)

사이트 링크 이름에 따라 사이트 링크를 반환합니다.Returns a site link based on a site link name.

사이트 링크 이름과 전송에 따라 사이트 링크를 반환합니다.Returns a site link based on a site link name and transport.

public:
 static System::DirectoryServices::ActiveDirectory::ActiveDirectorySiteLink ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ siteLinkName, System::DirectoryServices::ActiveDirectory::ActiveDirectoryTransportType transport);
public static System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLink FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string siteLinkName, System.DirectoryServices.ActiveDirectory.ActiveDirectoryTransportType transport);
static member FindByName : System.DirectoryServices.ActiveDirectory.DirectoryContext * string * System.DirectoryServices.ActiveDirectory.ActiveDirectoryTransportType -> System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLink
Public Shared Function FindByName (context As DirectoryContext, siteLinkName As String, transport As ActiveDirectoryTransportType) As ActiveDirectorySiteLink

매개 변수

context
DirectoryContext

이 사이트 링크에 유효한 DirectoryContext 개체입니다.An DirectoryContext object that is valid for this site link.

siteLinkName
String

찾을 사이트 링크의 이름입니다.The name of the site link to find.

transport
ActiveDirectoryTransportType

전송 형식을 지정하는 ActiveDirectoryTransportType 개체입니다.An ActiveDirectoryTransportType object that specifies the transport type.

반환

요청된 사이트 링크의 ActiveDirectorySiteLink 개체입니다.An ActiveDirectorySiteLink object for the requested site link.

예외

지정된 siteLinkName에서 주어진 context의 사이트를 찾을 수 없는 경우The site could not be found for the given siteLinkName in the context specified.

기본 디렉터리 서비스에 대한 호출에서 오류가 발생했습니다.A call to the underlying directory service resulted in an error.

대상 서버를 사용 중이거나 사용할 수 없습니다.The target server is either busy or unavailable.

이 예외는 다음과 같은 이유 때문에 발생합니다.This exception will occur for any one of the following reasons: - context 매개 변수의 대상이 포리스트, 구성 집합, 도메인 컨트롤러 또는 AD LDS 서버가 아닌 경우- The target in the context parameter is not a forest, configuration set, domain controller, or an AD LDS server.

  • siteLinkName이 빈 문자열인 경우
  • siteLinkName is an empty string.
  • context 또는 siteLinkNamenull인 경우context or siteLinkName is null.

    transport 매개 변수가 유효한 ActiveDirectoryTransportType 값이 아닙니다.The transport parameter is not a valid ActiveDirectoryTransportType value.

    transport 형식이 지원되지 않는 경우The transport type is not supported.

    제공된 자격 증명이 올바르지 않습니다.The credentials that were supplied are not valid.

    추가 정보

    사이트 링크 이름에 따라 사이트 링크를 반환합니다.Returns a site link based on a site link name.

    public:
     static System::DirectoryServices::ActiveDirectory::ActiveDirectorySiteLink ^ FindByName(System::DirectoryServices::ActiveDirectory::DirectoryContext ^ context, System::String ^ siteLinkName);
    public static System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLink FindByName (System.DirectoryServices.ActiveDirectory.DirectoryContext context, string siteLinkName);
    static member FindByName : System.DirectoryServices.ActiveDirectory.DirectoryContext * string -> System.DirectoryServices.ActiveDirectory.ActiveDirectorySiteLink
    Public Shared Function FindByName (context As DirectoryContext, siteLinkName As String) As ActiveDirectorySiteLink

    매개 변수

    context
    DirectoryContext

    이 사이트 링크에 유효한 DirectoryContext 개체입니다.An DirectoryContext object that is valid for this site link.

    siteLinkName
    String

    찾을 사이트 링크의 이름입니다.The name of the site link to find.

    반환

    요청된 사이트 링크의 ActiveDirectorySiteLink 개체입니다.An ActiveDirectorySiteLink object for the requested site link.

    예외

    지정된 siteLinkName에서 주어진 context의 사이트를 찾을 수 없는 경우The site could not be found for the given siteLinkName in the context specified.

    기본 디렉터리 서비스에 대한 호출에서 오류가 발생했습니다.A call to the underlying directory service resulted in an error.

    대상 서버를 사용 중이거나 사용할 수 없습니다.The target server is either busy or unavailable.

    이 예외는 다음과 같은 이유 때문에 발생합니다.This exception will occur for any one of the following reasons: - context 매개 변수의 대상이 포리스트, 구성 집합, 도메인 컨트롤러 또는 AD LDS 서버가 아닌 경우- The target in the context parameter is not a forest, configuration set, domain controller, or an AD LDS server.

    • siteLinkName이 빈 문자열인 경우
  • siteLinkName is an empty string.
  • context 또는 siteLinkNamenull인 경우context or siteLinkName is null.

    제공된 자격 증명이 올바르지 않습니다.The credentials that were supplied are not valid.

    추가 정보

    적용 대상