Category

Development Platform
Home > SourceCode/Document > Windows Develop > Windows Kernel > View Code
ptserver.idl
Package: shell.rar　[view]
Upload User: xhy777
Upload Date: 2007-02-14
Package Size: 24088k
Code Size: 16k
Category:

Windows Kernel

Development Platform:

Visual C++

ptserver.idl：Code Content
  1. //-------------------------------------------------------------------------//
  2. //
  3. //  Microsoft Windows
  4. //  Copyright (C) Microsoft Corporation, 1992 - 1996.
  5. //
  6. //  PTServer.idl : IDL source for advanced property server interface and 
  7. // supporting type definitions.
  8. //
  9. //-------------------------------------------------------------------------//
  10. cpp_quote("//-------------------------------------------------------------------------//")
  11. cpp_quote("//")
  12. cpp_quote("//  Microsoft Windows")
  13. cpp_quote("//  Copyright (C) Microsoft Corporation, 1992 - 1996.")
  14. cpp_quote("//")
  15. cpp_quote("//-------------------------------------------------------------------------//")
  17. import "oaidl.idl";
  18. import "ocidl.idl";
  19. import "propidl.idl";
  21. //-------------------------------------------------------------------------//
  22. //  BUGBUG - all property identifiers should eventually be publicized 
  23. //           in propidl.idl
  24. cpp_quote("")
  25. cpp_quote("//  FMTID_ImageSummaryInfo - Property IDs")
  26. cpp_quote("")
  27. cpp_quote("#define PIDISI_FILETYPE                 0x00000002L  // VT_LPWSTR")
  28. cpp_quote("#define PIDISI_CX                       0x00000003L  // VT_UI4")
  29. cpp_quote("#define PIDISI_CY                       0x00000004L  // VT_UI4")
  30. cpp_quote("#define PIDISI_RESOLUTIONX              0x00000005L  // VT_UI4")
  31. cpp_quote("#define PIDISI_RESOLUTIONY              0x00000006L  // VT_UI4")
  32. cpp_quote("#define PIDISI_BITDEPTH                 0x00000007L  // VT_UI4")
  33. cpp_quote("#define PIDISI_COLORSPACE               0x00000008L  // VT_LPWSTR")
  34. cpp_quote("#define PIDISI_COMPRESSION              0x00000009L  // VT_LPWSTR")
  35. cpp_quote("#define PIDISI_TRANSPARENCY             0x0000000AL  // VT_UI4")
  36. cpp_quote("#define PIDISI_GAMMAVALUE               0x0000000BL  // VT_UI4") 
  37. cpp_quote("")
  39. cpp_quote("")
  40. cpp_quote("//  FMTID_FaxSummaryInfo - Property IDs")
  41. cpp_quote("")
  42. cpp_quote("#define PIDFSI_TIME                0x00000002L  // VT_FILETIME")
  43. cpp_quote("#define PIDFSI_RECIPIENTNAME            0x00000003L  // VT_LPWSTR")
  44. cpp_quote("#define PIDFSI_RECIPIENTNUMBER          0x00000004L  // VT_LPWSTR")
  45. cpp_quote("#define PIDFSI_SENDERNAME               0x00000005L  // VT_LPWSTR")
  46. cpp_quote("#define PIDFSI_CALLERID                 0x00000006L  // VT_LPWSTR")
  47. cpp_quote("#define PIDFSI_TSID                     0x00000007L  // VT_LPWSTR")
  48. cpp_quote("#define PIDFSI_CSID                     0x00000008L  // VT_LPWSTR")
  49. cpp_quote("#define PIDFSI_ROUTING                  0x00000009L  // VT_LPWSTR")
  51. //-------------------------------------------------------------------------//
  52. cpp_quote( "// Source descriptor bits" )
  53. cpp_quote( "#define PTSD_DISKFILE 0x00000001" )
  54. cpp_quote( "#define PTSD_STORAGE 0x00000002" )
  55. cpp_quote( "#define PTSD_NSS 0x00000004" )
  56. cpp_quote( "#define PTSD_DATAOBJ 0x00000008" )
  58. //-------------------------------------------------------------------------//
  59. typedef struct tagPROPSERVERINFO
  60. {
  61. ULONG cbStruct ;
  62. ULONG mask ;
  63. ULONG ver ;
  64. ULONG dwSupport ; // source descriptor bits
  65. } PROPSERVERINFO, *PPROPSERVERINFO, *LPPROPSERVERINFO;
  67. //-------------------------------------------------------------------------//
  68. typedef struct tagPROPITEMHDR
  69. {
  70. ULONG cbStruct ;
  71. ULONG mask ;
  72. BSTR bstrName ;
  73. BSTR bstrDisplayName ;
  74. BSTR bstrQtip ;
  75. ULONG dwAccess ;
  76. LONG iOrder ;
  77. LONG lParam ;
  78. } PROPITEMHDR, *PPROPITEMHDR, *LPPROPITEMHDR ;
  80. cpp_quote( "// 'mask' member bit defs:" )
  81. cpp_quote( "#define PTI_NAME 0x00000001" )
  82. cpp_quote( "#define PTI_DISPLAYNAME 0x00000002" )
  83. cpp_quote( "#define PTI_QTIP 0x00000004" )
  84. cpp_quote( "#define PTI_ACCESS 0x00000008" )
  85. cpp_quote( "#define PTI_ORDER 0x00000010" )
  86. cpp_quote( "#define PTI_PARAM 0x00000020" )
  88. cpp_quote( "// 'dwAccess' bit defs" )
  89. cpp_quote( "#define PTIA_VISIBLE 0x00000001 // The property is displayed in the advanced property control" )
  90. cpp_quote( "#define PTIA_READ 0x00000010 // The property's value may be read" )
  91. cpp_quote( "#define PTIA_WRITE 0x00000020 // The property's value may be edited by the user" )
  92. cpp_quote( "#define PTIA_READWRITE PTIA_VISIBLE|PTIA_READ|PTIA_WRITE" )
  93. cpp_quote( "#define PTIA_READONLY PTIA_VISIBLE|PTIA_READ" )
  94. cpp_quote( "#define PTIA_WRITEONLY PTIA_VISIBLE|PTIA_WRITE" )
  96. cpp_quote("" )
  97. cpp_quote("//  Property Folder ID" )
  98. typedef GUID PFID ;
  99. typedef PFID *LPPFID ;
  100. cpp_quote("#define PFID_NULL GUID_NULL" )
  101. cpp_quote("#define IsEqualPFID(rpfid1, rpfid2)   IsEqualGUID((rpfid1), (rpfid2))" )
  102. cpp_quote("#if defined(__cplusplus)")
  103. cpp_quote("#ifndef _REFPFID_DEFINED")
  104. cpp_quote("#define _REFPFID_DEFINED")
  105. cpp_quote("#define REFPFID    const PFID&")
  106. cpp_quote("#endif // !_REFPFID_DEFINED")
  107. cpp_quote("#else // !__cplusplus")
  108. cpp_quote("#ifndef _REFPFID_DEFINED")
  109. cpp_quote("#define _REFPFID_DEFINED")
  110. cpp_quote("#define REFGUID             const PFID * const")
  111. cpp_quote("#endif // !_REFPFID_DEFINED")
  112. cpp_quote("#endif // !__cplusplus")
  115. cpp_quote("")
  116. cpp_quote("// Well-known Property Folder IDs")
  117. extern const PFID PFID_Description ;
  118. extern const PFID PFID_Origin ;
  119. extern const PFID PFID_ImageProperties ;
  120. extern const PFID PFID_AudioProperties ;
  121. extern const PFID PFID_VideoProperties ;
  122. extern const PFID PFID_MidiProperties ;
  123. extern const PFID PFID_FaxProperties ;
  125. //-------------------------------------------------------------------------//
  126. cpp_quote( "// PROPFOLDERITEM - advanced property folder item descriptor block." )
  127. typedef struct tagPROPFOLDERITEM
  128. {
  129. // (sync with PROPITEMHDR members)
  130. ULONG cbStruct ;
  131. ULONG mask ;
  132. BSTR bstrName ;
  133. BSTR bstrDisplayName ;
  134. BSTR bstrQtip ;
  135. ULONG dwAccess ;
  136. LONG iOrder ;
  137. LPARAM lParam ;
  139. // Folder-specific attributes:
  140. PFID pfid ;
  141. ULONG dwFlags ;
  142. } PROPFOLDERITEM, *PPROPFOLDERITEM, *LPPROPFOLDERITEM ;
  144. cpp_quote( "// PROPFOLDERITEM 'mask' bit defs:" )
  145. cpp_quote( "#define PTFI_NAME PTI_NAME" )
  146. cpp_quote( "#define PTFI_DISPLAYNAME PTI_DISPLAYNAME" )
  147. cpp_quote( "#define PTFI_QTIP PTI_QTIP" )
  148. cpp_quote( "#define PTFI_ACCESS PTI_ACCESS" )
  149. cpp_quote( "#define PTFI_ORDER PTI_ORDER" )
  150. cpp_quote( "#define PTFI_PARAM PTI_PARAM" )
  151. cpp_quote( "#define PTFI_FOLDERID 0x00000100" )
  152. cpp_quote( "#define PTFI_FLAGS 0x00000200" )
  153. cpp_quote( "#define PTFI_ALL 0xFFFFFFFF" )
  155. cpp_quote( "// PROPFOLDERITEM 'dwFlags' bit defs" )
  156. cpp_quote( "#define PTFIF_USERDEFINED 0x10000000 // The property is a user-defined folder" )
  158. //-------------------------------------------------------------------------//
  159. cpp_quote( "// PUID - property unique identifier." )
  160. cpp_quote( "// (devnote: do not modify order of members!)" )
  161. typedef struct tagPUID
  162. {
  163. FMTID   fmtid ;
  164. PROPID   propid ;
  165. VARTYPE   vt ;
  166. } PUID, *PPUID, *LPPUID ;
  168. //-------------------------------------------------------------------------//
  169. cpp_quote( "// Basic Property descriptor block" )
  170. typedef struct tagBASICPROPITEM
  171. {
  172. ULONG cbStruct ;
  173. ULONG dwAccess ;
  174. BOOL bDirty ;
  175. PUID puid ;
  176. PROPVARIANT val ;
  177. } BASICPROPITEM, *PBASICPROPITEM, *LPBASICPROPITEM ;
  179. //-------------------------------------------------------------------------//
  180. cpp_quote( "// PROPERTYITEM - advanced property item descriptor block." )
  181. typedef struct tagPROPERTYITEM
  182. {
  183. // (sync with PROPITEMHDR members)
  184. ULONG  cbStruct ;
  185. ULONG  mask ;
  186. BSTR  bstrName ;
  187. BSTR  bstrDisplayName ;
  188. BSTR  bstrQtip ;
  189. ULONG  dwAccess ;
  190. LONG  iOrder ;
  191. LPARAM  lParam ;
  193. // Property item-specific attributes:
  194. PUID  puid ;
  195. PFID  pfid ;
  196. ULONG  dwFlags ;
  197. ULONG  ctlID ;
  198. BSTR  bstrDisplayFmt ;
  199. ULONG  Reserved0 ;
  200. PROPVARIANT  val ;
  201. } PROPERTYITEM, *PPROPERTYITEM, *LPPROPERTYITEM ;
  203. cpp_quote( "// PROPERTYITEM 'mask' bit defs:" )
  204. cpp_quote( "#define PTPI_NAME PTI_NAME" )
  205. cpp_quote( "#define PTPI_DISPLAYNAME PTI_DISPLAYNAME" )
  206. cpp_quote( "#define PTPI_QTIP PTI_QTIP" )
  207. cpp_quote( "#define PTPI_ACCESS PTI_ACCESS" )
  208. cpp_quote( "#define PTPI_ORDER PTI_ORDER" )
  209. cpp_quote( "#define PTPI_PARAM PTI_PARAM" )
  210. cpp_quote( "#define PTPI_FMTID 0x00000100" )
  211. cpp_quote( "#define PTPI_PROPID 0x00000200" )
  212. cpp_quote( "#define PTPI_FOLDERID 0x00000400" )
  213. cpp_quote( "#define PTPI_FLAGS 0x00000800" )
  214. cpp_quote( "#define PTPI_VARTYPE 0x00001000" )
  215. cpp_quote( "#define PTPI_DISPLAYFMT 0x00002000" )
  216. cpp_quote( "#define PTPI_VALUE 0x00004000" )
  217. cpp_quote( "#define PTPI_ALL 0xFFFFFFFF" )
  219. cpp_quote( "// PROPERTYITEM 'dwFlags' bit defs" )
  220. cpp_quote( "#define PTPIF_BASIC         0x00000000  // The property control exhibits fundamental characteristics." )
  221. cpp_quote( "#define PTPIF_MRU           0x00000001  // The property control maintains a list of MRU values for the property." )
  222. cpp_quote( "#define PTPIF_ENUM          0x00000002  // The property control maintains a defined list of possible values." )
  223. cpp_quote( "#define PTPIF_TYPEMASK 0x0000000F  // mask for mutually exclusive values in low byte" )
  224. cpp_quote( "#define PTPIF_RANGED 0x00000010  // The property control validates a new value against a range of valid values" )
  225. cpp_quote( "#define PTPIF_INNATE     0x00000020 // The property's value is innate to its source, and cannot be modified." )
  226. cpp_quote( "#define PTPIF_USERDEFINED 0x10000000 // The property is a user-defined property (otherwise, the property is a 'stock' property." )
  228. cpp_quote( "// PROPERTYITEM 'ctlID' edit control specifiers" )
  229. typedef enum tagPTCTLID
  230. {
  231. PTCTLID_SINGLELINE_EDIT,
  232. PTCTLID_MULTILINE_EDIT,
  233. PTCTLID_DROPDOWN_COMBO,
  234. PTCTLID_DROPLIST_COMBO,
  235. PTCTLID_CALENDARTIME,
  236. PTCTLID_CALENDAR,
  237. PTCTLID_TIME,
  238. } PTCTLID, *PPTCTLID, *LPPTCTLID ;
  240. cpp_quote( "// PROPVARIANT_DISPLAY type: PROPVARIANT value + display string" )
  241. typedef struct tagPROPVARIANT_DISPLAY
  242. {
  243. PROPVARIANT val ;
  244. BSTR bstrDisplay ;
  245. } PROPVARIANT_DISPLAY, *PPROPVARIANT_DISPLAY, *LPPROPVARIANT_DISPLAY ;
  247. cpp_quote( "// IAdvancedPropertyServer::ReleaseProperties() 'dwFlags' argument values" )
  248. cpp_quote( "#define PTREL_DONE_ENUMERATING 0x00000001 // The control is finished enumerating property information for the source." )
  249. cpp_quote( "#define PTREL_CLOSE_SOURCE 0x00000002 // The source should be closed, if applicable." )
  250. cpp_quote( "#define PTREL_SOURCE_REMOVED 0xFFFFFFFF // The source has been removed from the control.  The server should release source resources permanently." )
  252. //-------------------------------------------------------------------------//
  253. // IBasicPropertyServer interface
  254. [
  255. uuid(C63D658C-7451-11d2-BE75-00A0C9A83DA1),
  257. helpstring("IBasicPropertyServer Interface"),
  258. pointer_default(unique)
  259. ]
  260. interface IBasicPropertyServer : IUnknown
  261. {
  262. [helpstring( "method AcquireBasic" )] 
  263. HRESULT AcquireBasic( [in] const VARIANT* pvarSrc, 
  264.   [in,out,size_is(cItems)] BASICPROPITEM rgItems[], 
  265.   [in]LONG cItems ) ;
  266.   
  267. [helpstring( "method PersistBasic" )] 
  268. HRESULT PersistBasic( [in] const VARIANT* pvarSrc, 
  269.   [in,out,size_is(cItems)] BASICPROPITEM rgItems[], 
  270.   [in]LONG cItems ) ;
  271. } ;
  273. //-------------------------------------------------------------------------//
  274. // IEnumPROPFOLDERITEM interface
  275. [
  276. uuid(1F183F5B-5C4D-11D1-8B83-080036B11A03),
  278. helpstring("IEnumPROPFOLDERITEM Interface"),
  279. pointer_default(unique)
  280. ]
  281. interface IEnumPROPFOLDERITEM : IUnknown
  282. {
  283. [helpstring( "method Next" )] 
  284. HRESULT Next( [in] ULONG cItems, 
  285.   [out,size_is(cItems), length_is(*pcItemsFetched)] PROPFOLDERITEM* rgFolderItem, 
  286.   [out] ULONG* pcItemsFetched ) ;
  288. [helpstring( "method Skip" )] 
  289. HRESULT Skip( [in] ULONG cItems ) ;
  291. [helpstring("method Reset")] 
  292. HRESULT Reset( ) ;
  294. [helpstring("method Clone")] 
  295. HRESULT Clone( [out] IEnumPROPFOLDERITEM ** ppEnum ) ;
  296. };
  298. //-------------------------------------------------------------------------//
  299. // IEnumPROPERTYITEM interface
  300. [
  301. uuid(1F183F5D-5C4D-11D1-8B83-080036B11A03),
  303. helpstring("IEnumPROPERTYITEM Interface"),
  304. pointer_default(unique)
  305. ]
  306. interface IEnumPROPERTYITEM : IUnknown
  307. {
  308. [helpstring( "method Next" )] 
  309. HRESULT Next( [in] ULONG cItems, 
  310.   [out,size_is(cItems), length_is(*pcItemsFetched)] PROPERTYITEM* rgPropertyItem, 
  311.   [out] ULONG* pcItemsFetched ) ;
  313. [helpstring( "method Skip" )] 
  314. HRESULT Skip( [in] ULONG cItems ) ;
  316. [helpstring("method Reset")] 
  317. HRESULT Reset( ) ;
  319. [helpstring("method Clone")] 
  320. HRESULT Clone( [out] IEnumPROPERTYITEM ** ppEnum ) ;
  321. };
  323. //-------------------------------------------------------------------------//
  324. // IEnumPROPVARIANT_DISPLAY interface
  325. [
  327. uuid(1F183F5F-5C4D-11D1-8B83-080036B11A03),
  329. helpstring("IEnumPROPVARIANT Interface"),
  330. pointer_default(unique)
  331. ]
  332. interface IEnumPROPVARIANT_DISPLAY : IUnknown
  333. {
  334. [helpstring("method Next"), local] 
  335. HRESULT Next( [in]  ULONG celt, 
  336.   [out] PROPVARIANT_DISPLAY* rgVar, 
  337.   [out] ULONG *pCeltFetched ) ;
  339. [helpstring("method RemoteNext"), call_as(Next) ] 
  340. HRESULT RemoteNext( [in] ULONG celt, 
  341.     [out, size_is(celt), length_is(*pCeltFetched)] PROPVARIANT_DISPLAY* rgVar, 
  342.     [out] ULONG *pCeltFetched ) ;
  344. [helpstring("method Skip")] 
  345. HRESULT Skip( [in] ULONG celt ) ;
  347. [helpstring("method Reset")] 
  348. HRESULT Reset() ;
  350. [helpstring("method Clone")] 
  351. HRESULT Clone( [out] IEnumPROPVARIANT_DISPLAY ** ppEnum ) ;
  352. };
  354. //-------------------------------------------------------------------------//
  355. // IAdvancedPropertyServer interface
  356. [
  357. uuid(1F183F59-5C4D-11D1-8B83-080036B11A03),
  359. helpstring("IAdvancedPropertyServer Interface"),
  360. pointer_default(unique)
  361. ]
  362. interface IAdvancedPropertyServer : IUnknown
  363. {
  364. [helpstring("method QueryServerInfo")] 
  365. HRESULT QueryServerInfo( [in,out] PROPSERVERINFO* pInfo ) ;
  367. [helpstring("method AcquireAdvanced")] 
  368. HRESULT AcquireAdvanced( [in] const VARIANT* pvarSrc,
  369.   [out]LPARAM * plParamSrc );
  371. [helpstring("method EnumFolderItems")] 
  372. HRESULT EnumFolderItems( [in]LPARAM lParamSrc, [out] IEnumPROPFOLDERITEM** ppEnum ) ;
  374. [helpstring("method EnumPropertyItems")] 
  375. HRESULT EnumPropertyItems( [in] const PROPFOLDERITEM* pFolderItem, 
  376.  [out] IEnumPROPERTYITEM ** ppEnum ) ;
  378. [helpstring("method EnumValidValues")]
  379. HRESULT EnumValidValues( [in] const PROPERTYITEM* pItem, 
  380.    [out] IEnumPROPVARIANT_DISPLAY ** ppEnum ) ;
  382. [helpstring("method PersistAdvanced")] 
  383. HRESULT PersistAdvanced( [in, out] PROPERTYITEM* pItem ) ;
  385. [helpstring("method ReleaseAdvanced")] 
  386. HRESULT ReleaseAdvanced( [in]LPARAM lParamSrc, [in] ULONG dwFlags ) ;
  388. } ;
  390. cpp_quote( "// STGFMT_NONE flag" )
  391. cpp_quote( "#define STGFMT_NONE 0xFFFFFFFF" )
  392. cpp_quote( "#define STGFMT_ERROR STGFMT_NONE" )
  394. cpp_quote( "// IPropertyServer::AcquireMultiple aValFlags flags" )
  395. cpp_quote( "#define AMPF_COMPOSITE 0x00000001" )
  396. cpp_quote( "#define AMPF_COMPOSITE_MISMATCH 0x00000002" )
  398. //-------------------------------------------------------------------------//
  399. // IPropertyServer interface - provides generic property services
  400. [
  401. uuid(1F183F58-5C4D-11D1-8B83-080036B11A03),
  403. helpstring("IPropertyServer Interface"),
  404. pointer_default(unique)
  405. ]
  406. interface IPropertyServer : IUnknown
  407. {
  408. [helpstring("method AcquireMultiple")] 
  409. HRESULT AcquireMultiple( [in]LONG cSrcs, 
  410.  [in]VARIANT* aSrcs,
  411.  [out]ULONG *aStgFmts,
  412.  [out]HRESULT *aResults,
  413.  [in]REFFMTID fmtid,
  414.  [in]LONG cProps,
  415.  [in]PROPSPEC* aSpecs, 
  416.  [out]PROPVARIANT* aVals,
  417.  [out]ULONG* aPropFlags ) ;
  419. [helpstring("method PersistMultiple")] 
  420. HRESULT PersistMultiple( [in]LONG cSrcs, 
  421.  [in]VARIANT* aSrcs,
  422.  [out]HRESULT *aResults,
  423.  [in]REFFMTID fmtid,
  424.  [in]LONG cProps,
  425.  [in]PROPSPEC* aSpecs, 
  426.  [in]PROPVARIANT* aVals,
  427.  [in]PROPID propidNameFirst ) ;
  429. HRESULT GetDisplayText( [in]REFFMTID fmtid,
  430. [in]LONG cProps,
  431. [in]PROPSPEC* aSpecs,
  432. [in]PROPVARIANT* aVals,
  433. [in]BSTR*  abstrFmt,
  434. [in]ULONG* adwFlags,
  435. [out] BSTR* abstrDisplay ) ;
  437. HRESULT AssignFromDisplayText( [in]REFFMTID fmtid,
  438.    [in]LONG cProps,
  439.    [in]PROPSPEC* aSpecs,
  440.    [in]BSTR* abstrDisplay,
  441.    [in]BSTR*  abstrFmt,
  442.    [in]ULONG* adwFlags,
  443.    [out]PROPVARIANT* aVals ) ;
  444. } ;