ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzakx_5.4.0.1/rzakxnewforegkeyex.htm

107 lines
7.4 KiB
HTML
Raw Normal View History

2024-04-02 14:02:31 +00:00
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005" />
<meta name="DC.rights.owner" content="(C) Copyright IBM Corporation 2005" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Example: New folder registry key" />
<meta name="abstract" content="A separate registry key must be defined for the root of each sub tree of objects that a plug-in chooses to add to the object hierarchy. This key contains information specific to the root folder of the sub tree." />
<meta name="description" content="A separate registry key must be defined for the root of each sub tree of objects that a plug-in chooses to add to the object hierarchy. This key contains information specific to the root folder of the sub tree." />
<meta name="DC.Relation" scheme="URI" content="rzakxsmpvbreg.htm" />
<meta name="DC.Relation" scheme="URI" content="rzakxprntkeyvalues.htm" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzakxnewforegkeyex" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Example: New folder registry key</title>
</head>
<body id="rzakxnewforegkeyex"><a name="rzakxnewforegkeyex"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Example: New folder registry key</h1>
<div><p>A separate registry key must be defined for the root of each sub tree of objects that a plug-in chooses to add to the object hierarchy. This key contains information specific to the root folder
of the sub tree.</p>
<p>Assign the registry key a meaningful folder name that is at least four characters in length.</p>
<pre>;--------------------------------------------------------------------
; Register a new folder
[HKEY_CLASSES_ROOT\IBM.AS400.Network\3RD PARTY plug-inS\IBM.Sample\folders\Sample]
"Parent"="AS4"
"Attributes"=hex:00,01,00,20
"CLSID"="{D09970E1-9073-11d0-82BD-08005AA74F5C}"
"NameID"=dword:00000082
"DescriptionID"=dword:00000083
"DefaultIconIndex"=dword:00000000
"OpenIconIndex"=dword:00000001
"AdminItem"="QIBM_SAMPLE_SMPFLR"</pre>
<div class="tablenoborder"><table cellpadding="4" cellspacing="0" summary="" frame="border" border="1" rules="all"><tbody><tr><td valign="top" width="22.22222222222222%">Parent</td>
<td valign="top" width="77.77777777777779%">A three-character ID that identifies the parent of the folder to be added.<p>See Parent field values for a listing of possible values.</p>
</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">Attributes</td>
<td valign="top" width="77.77777777777779%">A 4-byte binary field that contains the attributes for the folder, with the indicator bytes in reverse order. See the folder attribute flags defined for the IShellFolder::GetAttributesOf method in
the Microsoft<sup>®</sup> include file SHLOBJ.H.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">CLSID</td>
<td valign="top" width="77.77777777777779%">The CLSID of the IA4HierarchyFolder implementation that should be called by the iSeries™ Navigator to obtain the contents
of the folder. <p>For <span class="uicontrol">Java plug-ins</span>, the CLSID always should be: 1827A856-9C20-11d1-96C3-00062912C9B2.</p>
<p>For <span class="uicontrol">Visual Basic plug-ins</span>, the CLSID should always
be: 040606B1-1C19-11d2-AA12-08005AD17735}.</p>
</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">JavaClass</td>
<td valign="top" width="77.77777777777779%">The fully-qualified Java™ class name of the <span class="uicontrol">ListManager</span> implementation that should be
called by the iSeries Navigator to obtain the contents of the folder. This field should be omitted if the plug-in is not
a Java plug-in.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">VBClass</td>
<td valign="top" width="77.77777777777779%">The Program Identifier (ProgID) of the <span class="uicontrol">ListManager</span> implementation class that should be called by iSeries Navigator
to obtain the contents of the folder.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">VBInterface</td>
<td valign="top" width="77.77777777777779%">The GUID of the <span class="uicontrol">ListManager</span> implementation class' interface.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">NameID</td>
<td valign="top" width="77.77777777777779%">A double word that contains the resource ID of the string that should appear as the name of the folder in the iSeries Navigator
hierarchy.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">DescriptionID</td>
<td valign="top" width="77.77777777777779%">A double word that contains the resource ID of the string that should appear as the description of the folder in the iSeries Navigator
hierarchy.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">DefaultIconIndex</td>
<td valign="top" width="77.77777777777779%">A double word that contains the index into the NLS resource DLL of the plug-in for the icon that should be displayed for the folder in the iSeries Navigator hierarchy. This is a zero-based index into the resource DLL, not the resource ID of the icon. For indexing to work properly, the icon resource IDs should be assigned
sequentially.</td>
</tr>
<tr><td valign="top" width="22.22222222222222%">OpenIconIndex</td>
<td valign="top" width="77.77777777777779%">A double word that contains the index into the NLS resource DLL of the plug-in for the icon that should be displayed for the folder in the iSeries Navigator hierarchy whenever it is selected by the user. </td>
</tr>
<tr><td valign="top" width="22.22222222222222%">AdminItem</td>
<td valign="top" width="77.77777777777779%">A STRING that contains the Function ID of the Application Administration function that controls access to the folder. If this field is omitted, no Application Administration function controls access
to the folder. If specified, this must be the function ID of a Group or Administrable function. It cannot be the function ID of a Product Function.</td>
</tr>
</tbody>
</table>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzakxsmpvbreg.htm" title="The sample plug-includes two registry files: VBSMPDBG.REG, a windows-readbale registry file for use during development and VBSMPRLS.REG, a registry file for distribution on the iSeries server.">Customize the VB plug-in registry values</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzakxprntkeyvalues.htm" title="List of ID codes for the parent folders">Parent field values</a></div>
</div>
</div>
</body>
</html>