Share via

NPGetCaps 함수(npapi.h)

  • 아티클

네트워크에서 지원되는 서비스에 대한 정보를 반환합니다.

구문

DWORD NPGetCaps(
       DWORD ndex
);

매개 변수

ndex

반환 값

NPGetCaps 함수는 nIndex 매개 변수의 값에 따라 상수 또는 비트 마스크를 반환합니다. nIndex 값 중 몇 가지로 인해 상수가 반환됩니다. 그러나 대부분의 경우 nIndex 매개 변수는 쿼리할 서비스 집합을 지정하고 반환된 값은 이 집합에서 지원되는 서비스를 나타내는 비트 마스크입니다. 이러한 경우 반환 값이 0이면 집합의 서비스가 지원되지 않음을 나타냅니다.

다음 목록에서는 nIndex 에 포함될 수 있는 값과 각 값에 대해 반환되는 항목에 대한 설명이 표시됩니다.

####WNNC_ADMIN 네트워크 공급자가 지원하는 관리 기능을 나타내는 마스크를 반환합니다. 다음 중 하나 이상이 될 수 있습니다.

플래그 지원되는 함수
WNNC_ADM_DIRECTORYNOTIFY NPDirectoryNotify
WNNC_ADM_GETDIRECTORYTYPE NPGetDirectoryType

####WNNC_CONNECTION 네트워크 공급자가 지원하는 연결 함수를 나타내는 마스크를 반환합니다. 다음 중 하나 이상이 될 수 있습니다.

플래그 지원되는 함수
WNNC_CON_ADDCONECTION(0x00000001) NPAddConnection
WNNC_CON_CANCELCONNECTION(0x00000002) NPCancelConnection
WNNC_CON_GETCONNECTIONS(0x00000004) NPGetConnection
WNNC_CON_ADDCONECTION3(0x00000008) NPAddConnection3
WNNC_CON_GETPERFORMANCE(0x00000040) NPGetConnectionPerformance
WNNC_CON_DEFER(0x00000080) 지연된 연결은 NPAddConnection3에서 지원됩니다.

####WNNC_DIALOG 네트워크 공급자가 지원하는 대화 상자의 기능을 나타내는 마스크를 반환합니다. 다음 중 하나 이상이 될 수 있습니다.

플래그 지원되는 함수
WNNC_DLG_DEVICEMODE NPDeviceMode
WNNC_DLG_FORMATNETNAME NPFormatNetworkName
WNNC_DLG_GETRESOURCEINFORMATION NPGetResourceInformation
WNNC_DLG_GETRESOURCEPARENT NPGetResourceParent
WNNC_DLG_PERMISSIONEDITOR 이 플래그는 사용되지 않습니다.
WNNC_DLG_PROPERTYDIALOG NPPropertyDialog 및 NPGetPropertyText
WNNC_DLG_SEARCHDIALOG NPSearchDialog

####WNNC_ENUMERATION

지원되는 열거형 범위(있는 경우)를 나타내는 마스크를 반환합니다. 열거형 범위에 대한 자세한 내용은 참조 항목 NPOpenEnum의 매개 변수 섹션을 참조하세요. 다음 중 하나 이상이 될 수 있습니다.

플래그 지원되는 열거형 형식
WNNC_ENUM_GLOBAL(0x00000001) NPOpenEnum은 구현되며 네트워크에 있는 모든 리소스의 scope 지원합니다. 즉, NPOpenEnum은 RESOURCE_GLOBALNET 지원합니다.
WNNC_ENUM_LOCAL(0x00000002) NPOpenEnum은 구현되며 현재 연결된 모든 리소스의 scope 지원합니다. 즉, NPOpenEnum은 RESOURCE_CONNECTED 지원합니다.
WNNC_ENUM_CONTEXT(0x00000004) NPOpenEnum은 구현되며 사용자의 현재 및 기본 네트워크 컨텍스트와 연결된 모든 리소스의 scope 지원합니다. 즉, NPOpenEnum은 RESOURCE_CONTEXT 지원합니다.

참고 WNNC_ENUMERATION 0이 아닌 비트 마스크를 반환하는 경우 네트워크 공급자가 NPOpenEnum 을 지원하고 공급자가 NPEnumResource 및 NPCloseEnum도 지원한다는 것을 유추할 수 있습니다. NPOpenEnum을 지원하는 네트워크 공급자도 NPEnumResource 및 NPCloseEnum을 지원해야 하기 때문입니다.

####WNNC_NET_TYPE 네트워크 공급자가 지원하는 네트워크 유형을 나타내는 값을 반환합니다. 상위 단어에는 공급자 형식이 포함되고 하위 단어에는 하위 형식이 포함될 수 있습니다. 새 공급자에서 작업하는 개발자는 Microsoft에서 새 네트워크 유형을 가져와야 합니다. 올바른 네트워크 형식을 반환하지 않는 공급자는 WNET 함수가 예측할 수 없는 방식으로 동작하도록 할 수 있습니다.

네트워크 유형은 다음 중 하나일 수 있습니다.

  • WNNC_NET_10NET
  • WNNC_NET_INTERGRAPH
  • WNNC_NET_3IN1
  • WNNC_NET_LANMAN
  • WNNC_NET_9TILES
  • WNNC_NET_LANSTEP
  • WNNC_NET_APPLETALK
  • WNNC_NET_LANTASTIC
  • WNNC_NET_AS400
  • WNNC_NET_LIFENET
  • WNNC_NET_BMC
  • WNNC_NET_LOCUS
  • WNNC_NET_BWNFS
  • WNNC_NET_MASFAX
  • WNNC_NET_CLEARCASE
  • WNNC_NET_MSNET
  • WNNC_NET_COGENT
  • WNNC_NET_NETWARE
  • WNNC_NET_CSC
  • WNNC_NET_OBJECT_DIRE
  • WNNC_NET_DCE
  • WNNC_NET_PATHWORKS
  • WNNC_NET_DECOREB
  • WNNC_NET_POWERLAN
  • WNNC_NET_DISTENCT
  • WNNC_NET_PROTSTOR
  • WNNC_NET_EXTENDNET
  • WNNC_NET_RDR2SAMPLE
  • WNNC_NET_FARALLON
  • WNNC_NET_SHIVA
  • WNNC_NET_FJ REDIR
  • WNNC_NET_SUN_PC_NFS
  • WNNC_NET_FRONTIER
  • WNNC_NET_SYMFONET
  • WNNC_NET_FTP_NFS
  • WNNC_NET_TWINS
  • WNNC_NET_HOB_NFS
  • WNNC_NET_VINES
  • WNNC_NET_IBMAL

####WNNC_SPEC_VERSION WNNC_SPEC_VERSION51 반환합니다. 반환 값의 높음 및 낮음 단어에는 자격 증명 관리자에서 지원하는 WNet API 사양의 주 및 부 버전 번호가 포함됩니다.

####WNNC_START 공급자가 시작될 가능성이 있는지와 시기를 나타내는 다음 값 중 하나를 반환합니다. MPR은 모든 네트워크 공급자가 지정한 가장 긴 시간 제한 기간을 기다립니다.

플래그 시작 시간
0x0 공급자가 시작되지 않음을 나타냅니다(예: 사용하지 않도록 설정된 경우). MPR은 네트워크 공급자를 다시 시작하지 않습니다.
Time 공급자가 시작될 때까지의 시간(밀리초)을 나타냅니다.
0xFFFFFFFF 공급자가 언제 시작될지 알지 못했음을 나타냅니다. 네트워크 공급자가 이 값을 반환하는 경우 MPR은 기본값인 60초를 사용합니다.
0x1 공급자가 이미 시작되었음을 나타냅니다.

####WNNC_USER 네트워크 공급자가 NPGetUser 함수를 지원하는 경우 WNNC_USR_GETUSER 반환합니다.

설명

NPGetCaps에서 시작 시간을 반환하는 경우 MPR은 이 값을 사용하여 모든 네트워크 공급자를 다시 시작할 시기를 결정합니다. MPR은 호출한 공급자가 반환한 가장 긴 시작 시간을 사용합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 npapi.h

추가 정보

NPLogonNotify

NPPasswordChangeNotify